A Deadbeef Song Rating plugin
C Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


DeaDBeeF Song Rating plugin

A plugin enabling commands to rate track(s) by writing to the %rating% metadata tag. The commands are accessible from the context menu or by binding them to hotkeys.

Big thanks to Alexey Yakovenko for the DeaDBeeF music player.

Building & Installing

  1. Clone this repository
  2. Download deadbeef.h, for example from the DeaDBeeF source code.
  3. Run sh build.sh [path to dir with deadbeef.h]
  4. Run sh easyinstall.sh to install the plugin to ~/.local/lib/deadbeef, or copy rating.so yourself to your DeaDBeeF plugin folder.


Run sh easyuninstall.sh to remove the plugin from ~/.local/lib/deadbeef, or remove rating.so yourself from your DeaDBeeF plugin folder.


In order to show the rating tags in the playlist, add a new custom column with the following format:

$ifequal([%rating%], 5, *****,)$ifequal([%rating%], 4, ****,)$ifequal([%rating%], 3, ***,)$ifequal([%rating%], 2, **,)$ifequal([%rating%], 1, *,)

If you want, you can replace * with your rating indicator of choice. For example with beautiful awesome stars:

$ifequal([%rating%], 5,★★★★★,)$ifequal([%rating%], 4,★★★★,)$ifequal([%rating%], 3,★★★,)$ifequal([%rating%], 2,★★,)$ifequal([%rating%], 1,★,)

Or combine them with empty stars:

$ifequal([%rating%], 5,★★★★★,)$ifequal([%rating%], 4,★★★★☆,)$ifequal([%rating%], 3,★★★☆☆,)$ifequal([%rating%], 2,★★☆☆☆,)$ifequal([%rating%], 1,★☆☆☆☆,)$ifequal([%rating%], 0,☆☆☆☆☆,)


DeaDBeeF rating plugin
Copyright (C) 2016  Christian Hernvall

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.