README
1================================================
2 _
3 _ __ ___ _ __ __| | __ _ ___
4| '_ ` _ \| '_ \ / _` |/ _` / __|
5| | | | | | |_) | (_| | (_| \__ \
6|_| |_| |_| .__/ \__,_|\__,_|___/
7 |_|
8================================================
9
10mpdas is a MPD AudioScrobbler client
11supporting the 2.0 protocol specs.
12
13It is written in C++ and uses libmpdclient
14to retrieve the song data from MPD and
15libcurl to post it to Last.fm
16
17================================================
18
19NOTE: There is a manpage available as well:
20man mpdas
21
22To configure mpdas, simply create a file called
23.mpdasrc in your home directory or in
24$PREFIX/mpdasrc. To change $PREFIX, modify the
25Makefile.
26
27Syntax is easy. Example:
28
29username = lastfmuser
30password = password
31
32NOTE: In the past the password had to be an MD5
33hash. As of v0.4.3 this has changed due to
34Last.fm deprecating the previous authentication
35method. Please supply the password in plain-text
36from now on.
37
38Configuration options:
39
40username: Last.FM username
41password: Last.FM password (plain-text)
42host: MPD Host
43mpdpassword: MPD Password
44port: MPD Port
45runas: Change the user mpdas runs as
46debug: Print debug information
47service: Will scrobble to Libre.fm if set
48 to "librefm"
49
50================================================
51
52Features:
53- Sets now-playing status
54- Scrobbling (obviously)
55- Caching
56- Config files
57- User switching
58- "Love" tracks on Last.fm
59 (e.g. with 'mpc sendmessage mpdas love' and
60 'mpc sendmessage mpdas unlove' to revert)
61
62================================================
63
64Also checkout LICENSE
65
66================================================
67
68Contact:
69IRC: hrkfdn / irc.freenode.net
70Jabber: henrik@affekt.org
71WWW: http://www.50hz.ws
72
73================================================
74