MPD client using rofi or fzf
for the tagging_client:
eval $(perl -I ~/perl5/lib/perl5/ -Mlocal::lib=~/perl5)to your shell config and restart your terminal
cpanm --installdeps .
cpanm --installdeps .as root
Clerk can rate albums and tracks, which will be saved in MPDs sticker database as rating or albumrating. Track ratings should be compatible with all other MPD clients that support them. Albumratings are a unique feature to clerk, as far as I know.
It's also possible to store ratings in file tags. Currently this is supported for flac, ogg and mp3 files.
For this to work, simply set
tagging=true in clerk.conf file and set your music_path.
It’s even possible to tag files not on the same machine (On MPD setups with remote clients).
Simply copy your
clerk_rating_client to the machine hosting your audio files, edit
in config and start
clerk_rating_client. A systemd user service is available.
For the moment I use metaflac, mid3v2 and vorbiscomment to tag files, because I haven't found a good perl library for this task.
clerk integrates ratings fully into its database and exposes the ratings in track and album lists.
To filter by a specific rating use
r=n as part of your input. Sadly filtering for
r=1 will also show
in rofi interface you can work around this by filtering for
r=1\s. in fzf interface
If you don't like to see ratings in your track/album listings, simply increase the album_l setting in config.
Usage: clerk [command] [-f] Commands: -a Add/Replace album(s) to queue. -l Add/Replace album(s) to queue (sorted by mtime) -t Add/Replace track(s) to queue. -p Add stored playlist to queue -r [-A, -T] Replace current playlist with random songs/album -u Update caches Options: -f Use fzf interface Without further arguments, clerk starts a tabbed tmux interface Hotkeys for tmux interface can be set in $HOME/.config/clerk/clerk.tmux clerk version 4.0
Tab: select item(s) Enter: perform action on item
F1: albums view F2: tracks view F3: albums view (sorted by mtime) F4: playlist view F5: queue view (uses ncmpcpp by default, can be changed in clerk.conf) F10: random pane C-F5: previous song C-F6: toggle playback C-F7: stop playback C-F8: next song C-F1: show hotkeys C-q: quit clerk tmux interface
All tmux hotkeys can be changed in
$XDG_DATA_HOME for its files. Both variables are usually unset
and default to
$HOME/.local/share. These files are stored by clerk:
clerk.conf: config file.
clerk.tmux: clerk's tmux config
database.mpk: clerk's local database
CLERK_DATABASE variables to override file locations.