[% pagetitle = 'Artwork Setup' %]
[% lefttoright = '1' %]
[% PROCESS helpheader.html %]

<h4>What is Artwork?</h4>
 <p>Artwork is cover art from CD albums and typically a copy of the CD/album's cover.
 The Logitech Media Server can display artwork associated with each album.
 </p>

<h4>How does the Squeezebox software use it?</h4> 
 <p>Artwork is displayed in several places within the Squeezebox software.
  When you import (scan) your library - the scanner uses the first picture for all other media files found in that folder.
  So you should use one folder for each album.
 </p>
<h4>Where should I store the cover art?</h4>
 <ul>
   <li>You can embed the cover art into your media files by using your favourite mp3/flac tagging tool.<br>
   If embedded artwork is used - these pictures will always be the first used by the software.</li>     
   <li>You can store the artwork in the folder structure of your library.<br>
    Logitech Media Server looks in the same folder where the song file is stored, thus you would be looking for the same artfile in this case.</li>
   <li>You can store them into a separate folder for your cover art.<br>
    There is an option in Server Settings, Advanced, Formatting to set file names for Artwork or a central location for artwork files. 
    You can enter a specific filename if you use something not found in the list (eg, artwork.jpg).
    You may also create filenames based on song variables.  For further
    information scroll down to <a href="#songvariables" class="browseItemLink">Filenames based on song variables</a>.
   </li> 
 </ul>
  
<h4>How do I get cover art?</h4>
<p>Many sites that sell CDs include cover art in their catalog. With most browsers, you can right click on the image and select "Save image as..."</p>
<h4>Useful plugins</h4>
<p>Several third party developers have written utilities to automatically retreive cover art based on the internal tags of your MP3, Ogg, Flac, or other files. See 
<a href="http://forums.slimdevices.com/forumdisplay.php?4-3rd-Party-Software" target="_new" class="browseItemLink"
>3rd-Party-Software</a> for more information.</p>

<h4>Find albums with small /missing artwork used in your library:</h4>
 <p>The Music Artist Info plugin can support you to find albums with no or small artwork.
    If you enabled this plugin before a scan/rescan - it supports you with some additional Information under the extras in the main menue.
 </p>
 
<h4>Artwork file requirements</h4>
<p>The Squeezebox supports .GIF .PNG and .JPG files.</p>

<h4>Image sizes</h4>
 <p>The image files should be modest in size, as they are sized to fit on the HTML browser window or the device's display.
 A good size nowadays is a maximum of about 1500x1500. This should display reasonably well even on high resolution displays.
 Please keep in mind that the larger the file is, the longer it will take to process.</p>

<h4>Technical details</h4>
 <p>For each place in the skin that references a cover art image, the Squeezebox software performs the following search:</p>

 <p>Search in the current music directory for (in order):</p>
  <ul>
   <li>cover.jpg, cover.gif
   <li>folder.jpg, folder.gif
   <li>album.jpg, album.gif
  </ul>

 <p>The Logitech Media Server will use the first image file located in this search.</p>
 
<h4 id="songvariables">Filenames based on song variables</h4>
 <p>If your first character is %, the server then parses the rest of the string as an InfoFormat, the same as title format is created. As an example, you could create a single directory of songs and name all your artwork as artist-album.jpg.  For this, enter a setting of</p> 
<pre>&nbsp;&nbsp;%ARTIST-ALBUM.jpg</pre> 
 <p>for Artwork or Artwork Thumbnail in the server settings section.</p>

 <p>Available data elements are:</p> 
  <table>
   <tbody>
    <tr>
     <td><b>Setting </td>
     <td>Description </b></td>
    </tr>                 
    <tr>
     <td>CT</td>
     <td>content type</td>
    </tr>
    <tr>
     <td>TITLE</td>
     <td>Song title</td>
    </tr>
     <td>GENRE</td>
     <td>Song genre</td>
    </tr>
    <tr>
     <td>TRACKNUM</td>
     <td>tracknumber as an integer</td>
    </tr>
    <tr>
     <td>FS</td>
     <td>file size as reported by the underlying Operating System.</td>
    </tr>
    <tr>
     <td>ARTIST</td>
     <td>Artist for pop music, sometimes conductor for classical works.</td>
    </tr>
    <tr>
     <td>ALBUM</td>
     <td>Album name</td>
    </tr>
    <tr>
     <td>COMMENT</td>
     <td>Often the encoder used to create the MP3/FLAC/AAC/... file.</td>
    </tr>
    <tr>
     <td>YEAR</td>
     <td>Year published or released.</td>
    </tr> 
    <tr>
     <td>SECS</td>
     <td>total song length in seconds</td>
    </tr>
    <tr>
     <td>DURATION</td>
     <td>(minutes and seconds)</td>
    </tr>
    <tr>
     <td>VBR_SCALE</td>
     <td>vbr/cbr</td>
    </tr>  
    <tr>
     <td>BITRATE</td>
     <td>encoded bit rate</td>
    </tr>
    <tr>
     <td>VOLUME</td>
     <td>volume name</td>
    </tr>
    <tr>   
     <td>PATH</td>
     <td>Path to the song</td>
    </tr>
    <tr> 
     <td>FILE</td>
     <td>main file name of song</td>
    </tr>
    <tr>
     <td>EXT</td>
     <td>file extension of song (Type in Microsoft systems)</td>
    </tr>
    <tr>  
     <td>LONGDATE</td>
     <td>current date, long</td> 
    </tr>
    <tr> 
     <td>SHORTDATE</td>
     <td>current date, short</td>
    </tr>
    <tr>   
     <td>CURRTIME</td>
     <td>current time.</td>
    </tr>
   </tbody> 
  </table>
<p>Elements can be separated by anything (or nothing). The separators are only used if the data elements are present.</p>

<p>The above list is included for completeness, it is unlikely that anyone would actually want to have differing artwork files for songs of different bitrates, but the
ability is in the Logitech Media Server.
</P>

<p>Artwork internal to the  ID3 tags within a song takes precedence, followed by any specified filename in the server
settings.  If an Artwork Folder setting is used (in Server Settings, Additional, Interface) then that folder is searched first
for any file matching those given for Artwork.
</p>

[% PROCESS helpfooter.html %]