Permalink
Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
91 lines (61 sloc) 2.65 KB
XMMS2-Scrobbler
===============
About
-----
XMMS2-Scrobbler is a client for XMMS2 that feeds information about the songs
you played to last.fm, formerly known as AudioScrobbler.
XMMS2-Scrobbler supports "multi-scrobbling", i.e. it can talk to more than
one AudioScrobbler server.
The latest version can be found at
http://code-monkey.de/pages/xmms2-scrobbler.
Dependencies
------------
XMMS2-Scrobbler obviously depends on libxmmsclient (ships with XMMS2).
It also depends on CURL. That's it.
Installation
------------
Run "make" to build xmms2-scrobbler.
Run "make install" to install xmms2-scrobbler. The usual variables PREFIX
and DESTDIR are evaluated.
Alternatively, just copy the bin/xmms2-scrobbler file anywhere you like.
Usage
-----
First, you need to set up XMMS2-Scrobbler's config files.
Config values that are specific to the AudioScrobbler server go in
~/.config/xmms2/clients/xmms2-scrobbler/$SERVER_NAME/config.
You will usually have .../clients/xmms2-scrobbler/lastfm/config
and maybe .../clients/xmms2-scrobbler/librefm/config.
These server-specific config files contain your username and password
and the URL to use:
mkdir ~/.config/xmms2/clients/xmms2-scrobbler/lastfm
echo -e "user: foo\npassword: bar\nhandshake_url: http://post.audioscrobbler.com\n" > \
~/.config/xmms2/clients/xmms2-scrobbler/lastfm/config
For libre.fm, use
handshake_url: http://turtle.libre.fm
Optionally, if you're behind a proxy, you'll need to tell XMMS2-Scrobbler
about that proxy. This information applies to all servers and so goes in
.../clients/xmms2-scrobbler/config.
echo -e "proxy: my.proxy\nproxy_port: 8080\n" >> \
~/.config/xmms2/clients/xmms2-scrobbler/config
Next, create a symlink to the script in ~/.config/xmms2/startup.d.
This will make xmms2d start xmms2-scrobbler on startup. When xmms2d is
killed, xmms2-scrobbler will exit automatically.
In case anything doesn't work as it should, have a look at
~/.config/xmms2/clients/xmms2-scrobbler/logfile.log.
Upgrading from 0.3.x
--------------------
The 0.3 series of XMMS2-Scrobbler didn't use server-specific config files.
To upgrade your configuration, do like this:
cd ~/.config/xmms2/clients/xmms2-scrobbler
# Create a config directory for the last.fm server
mkdir lastfm
# Copy the old config to the last.fm-specific config file
grep -v ^proxy config > lastfm/config
# Remove the last.fm-specific lines from the generic config file
grep ^proxy config > proxy_config
mv proxy_config config
# Move the old queue file to the lastfm directory
mv queue lastfm/
# Append the handshake_url config value
echo -e "\nhandshake_url: http://post.audioscrobbler.com\n" >> \
lastfm/config