How to add artwork

You can add your own artwork for folders and playlists so your frontend shows custom thumbnails instead of generic default images.

This guide explains:

• which image formats are supported
• how to name artwork files
• where to place those files
• what happens when a playlist image is missing

Supported image formats

The following file types are supported and checked in this order. The first matching image file is used:

• webp
• png
• jpeg
• jpg
• bmp
• gif

You can use any one of these formats for both folder artwork and playlist artwork.

Folder

To set artwork for a folder, place an image file named folder.ext inside that folder.

Replace .ext with one of the supported extensions.

Examples:

• folder.webp
• folder.jpg
• folder.png

Playlists

To set artwork for a playlist, use the same base filename as the playlist file.

Example:

• Playlist file: Jazz.m3u8
• Artwork file: Jazz.jpg (or Jazz.webp, Jazz.png, and so on)

If a matching playlist artwork file is not found, the folder artwork is used as a fallback.

Example folder structure

Use this as a reference:

Music/
|-- folder.jpg
|-- Jazz/
|   |-- folder.png
|   |-- Jazz.m3u8
|   |-- Jazz.jpg
|   |-- Smooth.m3u8
|   `-- smooth-track01.mp3
`-- Rock/
    |-- folder.webp
    |-- RockHits.m3u8
    `-- track01.mp3

In this example:

• Music/folder.jpg is the artwork for the top-level Music folder.
• Music/Jazz/folder.png is the artwork for the Jazz folder.
• Music/Jazz/Jazz.jpg is used for the Jazz.m3u8 playlist.
• Music/Jazz/Smooth.m3u8 has no matching Smooth.* image, so the Jazz folder artwork is used.