blob: 903dc44bf453327b5722e1db848837e8c64b715f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
# clerk - mpd client, based on rofi (or dmenu)
# Version 2.0
![multi_keys branch]
(images/clerk_multi_keys.jpg)
#### clerk is a rofi-driven mpd client with some advanced features.
# Functions:
* Play random album
* Play x random tracks
* Browse Library (Artist > Album > Tracks)
* Browse local filesystem (needs unix socket in mpd.conf)
* 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)
* Lookup artist/album/lyrics in webbrowser
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:
* dmenu2 (https://bitbucket.org/melek/dmenu2) OR
* rofi (https://github.com/DaveDavenport/rofi)
* mpc
* python-mpd2 (https://github.com/Mic92/python-mpd2)
* python-notify2
Hint: When using rofi, you can use Shift+Enter to execute several commands
e.g. adding more than one song.
# Optional Dependencies
* surfraw (for lookup)
* 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
Some software (beets, I look at you!) loves to add duplicate tags.
For example beets adds track and tracknumber tags, no matter what file format
is handled. MPD will return tracknumber twice for such files.
I tried to work around most cases, but still. keep your tags clean!
|
