dev builds
themes manual
device status forums
mailing lists
IRC bugs
dev guide

Search | Go
Wiki > Main > DocsIndex > CustomWPS > AlbumArt

Album Art Display on the WPS


This feature allows for the display of an image representing the currently playing track on the While Playing Screen. This picture can be the cover art of the album the song belongs to, or a picture specific to the track itself, depending on how you name the file. For details about how to use the feature, see the manual, appendix C - Theme Tags (especially the section named Album Art). This page contains troubleshooting and helpful tips about programs to use for generating/collecting album art.


Here are a few possible things that could cause a WPS not to display album art pictures (in no particular order) :
  • The syntax of the %Cl% tag is wrong. To see if that's the problem you can try something simple : %Cl|x|y|||.
  • The file names are wrong. Try using a "cover.bmp" file to see if it that's the problem.
  • Your bitmaps are invalid.
If lines are being drawn over your album art picture, there are two things you should check:
  • Put the %C tag on the last line of your WPS. That way it will be drawn last, over the lines that were covering it previously.
  • To place text on the right of the album art picture, using a viewport is recommended over spaces. Otherwise, lines might appear over the album art picture.

Useful tools

Embedded Cover Art

  • QartRockbox (Windows and Linux) This application is for extract artwork embedded in mp3, ogg, flac, ape and mp4 files in jpeg format for display in Rockbox firmware. It saves files like "artist-album.jpeg". Also can choose the size of the picture. This application is developed in Qt 4.6.3 and taglib.

  • Album Art Extracter for RockBox (for Windows and Linux with Mono) This application can extract and convert massively the album art embedded in music files, and create the necessary files in BMP or JPG format to display album art correctly in RockBox. It supports the creation on all locations and filename conventions which Rockbox looks for Album Art. Also can scale images to size desired.

  • Artwork Extraction Perl Script A small perl script to retrieve album art images from the APIC frame of ID3v2 MP3 tags. It places the album art image file in the MP3 folder with the name of your choosing. It requires the MP3::Tag, File::Find, Image::Magick Perl modules. (Automatically scales images to 175x175 (retaining image ratio), though that can be changed by editing or removing the line that scales them.)

  • EasyTAG EasyTAG is a utility for viewing and editing tags for MP3, MP2, MP4/AAC, FLAC, Ogg Vorbis, MusePack, Monkey's Audio and WavPack files. Its simple and nice GTK+ interface makes tagging easier under GNU/Linux or Windows. (Embedded images can be saved to the hard drive to be edited with other applications.)

Cover Art Downloading

Format Conversion

  • imgp - Fast multi-core batch image resizer and rotator (for Linux); simple command for adapting the images in the current directory to a 320x320 resolution. Visit all directories recursively, overwrite source images, ignore images with matching hres or vres but convert PNG images to JPEG:
    $ imgp -x 320x320 -wrack

  • FastStone Photo Resizer (for Windows)
  • IrfanView -- freeware: supports batch conversion (for Windows)
  • iRiver H3XX Album Art Manager (for Windows). Note that despite the name, there is nothing iRiver specific about it. It looks for jpegs, resizes, converts and renames (either cover.bmp or .bmp if enough files in the folder can be ID3-identified to belong to the same album) them, leaving the copy in the same folder as the original. It works perfectly as long as your image files have some easy to recognise name, such as folder.jpg.
  • RockBox WPS cover creator script for Amarok 1
  • Here is a small bash script inspired by "macgabhs" (original here on MisticRiver) that should do the job (uses ImageMagick). Run it from your music directory on your DAP.
    find -iname "cover.jpg" -o -iname "cover.gif" -o -iname "cover.png" | while read file
        do convert "$file" -thumbnail 130x130 "${file%/*}"/cover.bmp
    To convert all the pictures and not only "cover.*" files, use this instead :
    find -iname "*.jpg" -o -iname "*.gif" -o -iname "*.png" | while read file
        do convert "$file" -thumbnail 130x130 "${file%.*}".bmp

  • Rockbox art converter script (for Windows Scripting Host) Install leadcommandlineutils.exe from the archive, extract content of to x:\Windows\System and run progbar.reg. If you want to use the outputname option you need to overwrite the rockboxartsupdate.vbs with the updated version that is uploaded in a more recent post of the linked thread.

    Accepted parameters:
    /artname: (default: folder.jpg) /size: (default: 150) /outputname: (default: cover.bmp) /source:"x:" (default: ask)
    Example commandline:
    RockboxArtsUpdate.vbs /artname:cover.jpg /size:140 /outputname:cover.140x140 /source:"F:\Music\"

  • Shell script for converting progressive JPEGs to baseline. Requires ImageMagick. Rewritten by bobba_mosfet. (Forum post here)
    #!/usr/bin/env bash
    function process_jpeg()
     idout="$(identify -verbose "$img" | grep -i interlace | grep -i none)"
     if [[ -z "$idout" ]]
      echo "-------------------------"
      echo "$img is progressive"
      echo "....making copy of original with .prog extension"
      /bin/cp -f "$img" "$img.prog"
      echo "....converting to baseline"
      convert "$img" -interlace none "$img"
      echo "....done!"
    command -v identify >/dev/null 2>&1 || { echo >&2 "identify is required, but not installed.  Aborting."; exit 1; };
    while IFS= read -r -d '' file; do process_jpeg "$file"; done < <(find "$PWD" -type f \( -iname "*.jpg" -o -iname "*.jpeg" \) -print0)

How to Use Embedded iTunes Cover Art On An iPod

For Windows Users

iPod Album Art Extractor

This application can extract the album art embedded in the music files in a iPod, and create the necessary files in BMP format to display album art correctly in RockBox. The entire process in fully automated. You just need to make sure your files are properly tagged.

For more information and downloading this app, visit the author's website.

Media Monkey procedure

This procedure was posted by ryan2632 on the forums (original topic here). I haven't tested it so I can't guarantee it will work as expected.

ALERT! NOTE: This method does NOT work for files in AAC format if you use MediaMonkey 2.x

ALERT! NOTE: This method does NOT work if your music directory structure is more than two folders deep. It was written assuming you were using the iTunes database directory structure.

  • Extracting and resizing the art
    1. download MediaMonkey
    2. grab the Album Art Tagger Script from here. (about 1/3 way down the page)
    3. install both, and launch the app
    4. click on your iPod in the left pane, and let the song list load. select all (or whichever you want) and go to Tools -> Scripts -> Album Art Tagger
    5. select option 4 "Extract artwork and resize external image"
    6. in the text box below type in:
      replace 'D:\art\' with wherever you want it to extract the images. make sure you have created the folder first.
    7. click go and let it do it's work. after it scans, it will popup a confirmation dialogue. press OK, and it will pull all the art and resize it into that folder.

  • Generating Album Art of different sizes
    1. Instead of putting in
      you can put in
    2. Change the album art size in the same window to the album art size you inputed in the step above. This will generate out album art images with a name such as "cover.100x100.bmp".
    3. You can do this multiple times and generate out different sizes this way for pictureflow and different WPS'.

  • Converting from JPEG to BMP
    1. download Faststone Photo Resizer from here and install
    2. under the 'Conversion' tab, Navigate to the folder with your extracted JPG's and press Add All
    3. Set the output format to BMP and click Options. Make sure it is still at 24 bit
    4. Choose your output folder
    5. Press Start and sit back.

  • Finishing up
    1. Move all the BMP's to IPODDRIVE:\iPod_Control\Music. Or up to one folder down. See above. Pay attention to the limited number of places you can put the cover art.

For Mac OS X Users (with iTunes)

In order to extract id3 album art to the album folder

1. Download and install Doug's Scripts for iTunes - Save Album Art to Album Folder - from here

2. Highlight the albums or tracks you would like to extract from. You can chose to extract from track art to album folder or album art to album folder. Choose album art, especially for larger libraries.


If art is extracted into a form which Rockbox cannot read, you can create an automator workflow to search for .png, etc within your music folders and convert them to .jpeg or .bmp.

To create the workflow, open Automator, choose Custom.

1. Drag "Find Finder Items" into the workflow.
2. Choose the folder where you store your music in the Find Finder dialogue.
3. Choose "Extension" "is equal to" "png" or other undesirable image extensions.
4. Drag "Change Type of Images" into the workflow.
5. Choose To Type: "JPEG" or "BMP" whichever you prefer.
6. Save the file and run it.

When you create the workflow, you are able to choose whether you would like to save the original image file, I chose "no" for this, you can choose to save it if you would like. The program will automatically add this step if you decide to do this.

r83 - 25 Sep 2023 - 12:07:25 - SolomonPeachy

Parents: DocsIndex > CustomWPS
Copyright © by the contributing authors.