# Screenshot (V3)
![Screenshot]
(images/clerk_multi_keys.jpg)

#### clerk is a rofi-driven mpd client with some advanced features.

# Features:

* Play random album
* Play x random tracks
* Add/Insert/Replace Albums/Songs
* Manage current Queue
* Show Albums/Tracks by currently playing Artist and add those to Queue.
* Enable or disable scrobbling (with support for remote mpdscribble/mpdas)
* Love current song on lastfm (Using lastfm-mpd-cli or mpdas)
* Rate albums/tracks (Stored in mpds sticker database)
 * local copies are stored, allowing a tag based search (yet to come)
* Load rated albums/tracks
* Play Similar Songs (based on lastfm)
* Control mpd options (modes, replaygain, crossfade)

Written completely functional, nearly every option is accessible
from command line.
For example `clerk --random track` will play random songs.

see `clerk -h` for all default arguments.

From every database related menu it's possible to add/insert/replace one or multple entries.
For this to work, you need a recent rofi build from git.

# Dependencies:

* rofi (https://github.com/DaveDavenport/rofi)
* mpc
* python-mpd2 (https://github.com/Mic92/python-mpd2)

# Optional Dependencies

* lastfm-mpd-cli for loving tracks (https://github.com/morendi/lastfm-mpd-cli)
  (Not needed when using mpdas instead of mpdscribble)
* mpd-sima (for Similar Artists playback)

# Installation

1. Install dependencies (each binary needs to be in your $PATH)
2. Copy config.clerk to $HOME/.config/clerk/config and edit it.
3. Copy clerk and clerk_helper to $PATH
4. Run clerk

For arch linux there is a package in [AUR](https://aur.archlinux.org/packages/clerk-git/)

# Important

clerk is heavily depending on a well structured database.
All your files need these tags in order for clerk to work as intended:
* albumartist
* artist
* date
* album
* tracknumber
* title