Appendix B. Theme Tags
193
•
The images must be in BMP format
•
The image tag must be on its own line
•
The ID is case sensitive, giving 52 different ID’s
•
The size of the LCD screen for each player varies. See table below for appropriate
sizes of each device. The x and y coordinates must respect each of the player’s
limits.
B.20. 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.
B.20.1. Limitations
Rockbox does not support album art embedded in your files’ tags, and will instead look
for a picture located on disk. In addition to this, the pictures must be in either BMP
or JPEG format. 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 progessive and multi-scan images require much more
memory to decode.
B.20.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.
./filename.{jpeg,jpg,bmp}
2.
./albumtitle.{jpeg,jpg,bmp}
3.
./cover.{jpeg,jpg,bmp}
4.
./folder.jpg
5.
/.rockbox/albumart/albumartist-albumtitle.{jpeg,jpg,bmp}
6.
../albumtitle.{jpeg,jpg,bmp}
7.
../cover.{jpeg,jpg,bmp}
The Rockbox manual
Toshiba Gigabeat F and X Series