manual/appendix/album_art.tex

   1 % $Id: wps_tags.tex 19361 2008-12-07 23:00:15Z bluebrother $ %
   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 format.
  14
  15 \section{Where to put album art}
  16
  17 The pictures can be named a number of different ways, and placed a number of
  18 different locations. You can have pictures specific to the file or the album
  19 or use a generic picture. You can place the picture in the same direcotry
  20 as the file, in the parent directory or in a fixed directory named
  21 \fname{/.rockbox/albumart/}. The order Rockbox uses when looking for a picture
  22 is as follows:
  23
  24 \begin{enumerate}
  25 \item  \fname{./filename.bmp}
  26 \item  \fname{./albumtitle.bmp}
  27 \item  \fname{./cover.bmp}
  28 \item  \fname{/.rockbox/albumart/artist-albumtitle.bmp}
  29 \item  \fname{../albumtitle.bmp}
  30 \item  \fname{../cover.bmp}
  31 \end{enumerate}
  32
  33 The following characters will be replaced with an underscore (\_) when looking
  34 for albumtitle.bmp or artist-albumtitle.bmp: \textbackslash{} / : \textless{}
  35 \textgreater{} ? * \textbar{}. Doublequotes will be replaced by single qutoes.
  36 See \wikilink{AlbumArt} in the wiki for more details and programs that will
  37 help you automate the process of putting album art on your \dap{}.