C. Album Art

Rockbox allows you to put the album art, or another image related to the music on your
player to display it in the PictureFlow plugin or in the theme. For this feature to work, there
are a few requirements.

C.1Limitations

Rockbox supports embedded album art only for some specific formats, see section B.2.1 for
full details. It additionally supports loading images located on the hard disk. PictureFlow is
currently unable to use embedded album art. The image files must be in either BMP or JPEG
format, while embedded album art is currently limited to JPEG. Embedded JPEG images
must not be unsynchronized. Rockbox does not support RLE-compressed BMP files, nor does
it support progressive and multi-scan JPEG files. JPEG files must consist of a single scan with
interleaved components, as progressive and multi-scan images require much more memory to
decode.

C.2Where to put album art

The pictures can be named a number of different ways, and placed to a number of different
locations. You can have pictures specific to the file or the album or use a generic picture. You
can place the picture in the same directory as the file, in the parent directory or in a fixed
directory named /.rockbox/albumart/. The order Rockbox uses when looking for a
picture is as follows (a list in braces means that those file extensions are tried in that
order):

1.

embedded (JPEG images in ID3v2 or MP4 tags only)

2.

./filename.{jpeg,jpg,bmp}

3.

./albumtitle.{jpeg,jpg,bmp}

4.

./cover.{jpeg,jpg,bmp}

5.

./folder.jpg

6.

/.rockbox/albumart/albumartist-albumtitle.{jpeg,jpg,bmp}

7.

../albumtitle.{jpeg,jpg,bmp}

8.

../cover.{jpeg,jpg,bmp}

The following characters will be replaced with an underscore (_) when looking for
albumtitle.bmp or albumartist-albumtitle.bmp: \ / : < > ? * |. Doublequotes will be replaced
by single quotes. If no album artist is set, artist will be used instead. See AlbumArt in the wiki
for programs that will help you automate the process of putting album art on your
player.