manual/appendix/album_art.tex

   1 % $Id$ %
   2 \chapter{\label{ref:album_art}Album Art}
   3 \section{Introduction}
   4
   5 Rockbox allows you to put the album art, or another image related to the music
   6 on your \dap{} to display it in the PictureFlow plugin\opt{albumart}{ or in the
   7 WPS}. For this feature to work, you must observe a few rules.
   8
   9 \section{Limitations}
  10
  11 Rockbox does not support album art embedded in your files' tags, and will
  12 instead look for a picture located in the filesystem. In addition to this, the
  13 pictures must be in the BMP or JPEG formats. Rockbox does not support
  14 RLE-compressed BMP files, nor does it support progressive and multi-scan
  15 JPEG files. JPEG files must consist of a single scan with interleaved components,
  16 as progessive and multi-scan images require much more memory to decode.
  17
  18 \section{Where to put album art}
  19
  20 The pictures can be named a number of different ways, and placed to a number of
  21 different locations. You can have pictures specific to the file or the album
  22 or use a generic picture. You can place the picture in the same directory
  23 as the file, in the parent directory or in a fixed directory named
  24 \fname{/.rockbox/albumart/}. The order Rockbox uses when looking for a picture
  25 is as follows (a list in braces means that those file extensions are tried in
  26 that order):
  27
  28 \begin{enumerate}
  29 \item  \fname{./filename.\{jpeg,jpg,bmp\}}
  30 \item  \fname{./albumtitle.\{jpeg,jpg,bmp\}}
  31 \item  \fname{./cover.\{jpeg,jpg,bmp\}}
  32 \item  \fname{./folder.jpg}
  33 \item  \fname{/.rockbox/albumart/artist-albumtitle.\{jpeg,jpg,bmp\}}
  34 \item  \fname{../albumtitle.\{jpeg,jpg,bmp\}}
  35 \item  \fname{../cover.\{jpeg,jpg,bmp\}}
  36 \end{enumerate}
  37
  38 The following characters will be replaced with an underscore (\_) when looking
  39 for albumtitle.bmp or artist-albumtitle.bmp: \textbackslash{} / : \textless{}
  40 \textgreater{} ? * \textbar{}. Doublequotes will be replaced by single qutoes.
  41 See \wikilink{AlbumArt} in the wiki for more details and programs that will
  42 help you automate the process of putting album art on your \dap{}.