manual/appendix/album_art_info.tex

   1 \chapter{\label{ref:album_art}Album Art}
   2 Rockbox allows you to put the album art, or another image related to the music
   3 on your \dap{} to display it in the PictureFlow plugin\opt{albumart}{ or in the
   4 theme}. For this feature to work, there are a few requirements.
   5
   6 \section{Limitations}
   7
   8 \opt{albumart}{%
   9    Rockbox supports embedded album art only for some specific formats, see
  10   \reference{ref:featureset_for_generic_metadata_tags} for full details. It additionally
  11   supports loading images located on the \disk{}. PictureFlow is currently unable to
  12   use embedded album art.
  13 }%
  14 \nopt{albumart}{%
  15    Rockbox currently only supports loading images located on the
  16    \disk{} for use in PictureFlow.
  17 }%
  18 The image files must be in either BMP or JPEG format\opt{albumart}{, while embedded
  19 album art is currently limited to JPEG.  Embedded JPEG images must not be
  20 unsynchronized}. Rockbox does not support RLE-compressed BMP files, nor does it
  21 support progressive and multi-scan JPEG files.
  22 JPEG files must consist of a single scan with interleaved components,
  23 as progessive and multi-scan images require much more memory to decode.
  24
  25 \section{Where to put album art}
  26
  27 The pictures can be named a number of different ways, and placed to a number of
  28 different locations. You can have pictures specific to the file or the album
  29 or use a generic picture. You can place the picture in the same directory
  30 as the file, in the parent directory or in a fixed directory named
  31 \fname{/.rockbox/albumart/}. The order Rockbox uses when looking for a picture
  32 is as follows (a list in braces means that those file extensions are tried in
  33 that order):
  34
  35 \begin{enumerate}
  36 \item  embedded (JPEG images in ID3v2 or MP4 tags only)
  37 \item  \fname{./filename.\{jpeg,jpg,bmp\}}
  38 \item  \fname{./albumtitle.\{jpeg,jpg,bmp\}}
  39 \item  \fname{./cover.\{jpeg,jpg,bmp\}}
  40 \item  \fname{./folder.jpg}
  41 \item  \fname{/.rockbox/albumart/albumartist-albumtitle.\{jpeg,jpg,bmp\}}
  42 \item  \fname{../albumtitle.\{jpeg,jpg,bmp\}}
  43 \item  \fname{../cover.\{jpeg,jpg,bmp\}}
  44 \end{enumerate}
  45
  46 The following characters will be replaced with an underscore (\_) when looking
  47 for albumtitle.bmp or albumartist-albumtitle.bmp: \textbackslash{} / : <
  48 > ? * |. Doublequotes will be replaced by single quotes.
  49 If no album artist is set, artist will be used instead. See \wikilink{AlbumArt}
  50 in the wiki for programs that will help you automate the process of putting
  51 album art on your \dap{}.