C
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
AUTHORS
COPYING
Makefile
README

README

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