Appendix C. Album Art
210
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.1. Limitations
Rockbox supports embedded album art only for some specific formats, see section
(page
) 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.2. Where 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 Rockbox manual
(version 3.14)
Toshiba Gigabeat F and X Series
