Skip to content
This page is for the development version of rmpc. Make sure your version matches the selected documentation.

Stickers

Rmpc uses MPD’s stickers for some of its functionality like rating, liked status and might use more in the future.

These stickers are simple key-value pairs attached to songs and can be used to store arbitrary data. You must have sticker_file set in your MPD’s configuration to use this functionality.

You can display these stickers using the Sticker("<name>") property.

These stickers aim to be compatible with the Compatible with the growing spec at mpd-stickers.

NameDescription
ratingUsed to store ratings. Has to be a valid positive integer in the 0-10 range. Numbers outside this range are permitted too if configured to do so but might not work in other MPD clients/rmpc functionality.
likeUsed to store like status. Possible values are 0, 1 and 2 meaning “disliked”, “neutral” and “liked” respectively
playCountHow many times a song was played. Requires configuration.
lastPlayedUnix timestamp (seconds) of the last time the song was played. Can be read by the Sticker pane (e.g. a “recently played” view). Must be written by an external tool such as an rmpcd plugin or an on_song_change hook.