Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 6505184a8f

Fetching latest commit…

Cannot retrieve the latest commit at this time

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.
The latest version can be found at
http://code-monkey.de/pages/xmms2-scrobbler.


Dependencies
------------

XMMS2-Scrobbler obviously depends on libxmmsclient (ships with XMMS2),
Ruby, and the Ruby bindings for libxmmsclient (they ship with XMMS2 as well).
In addition to this, you'll need the "event-loop" package for Ruby.
Tarballs and gems are available at
http://www.brockman.se/software/ruby-event-loop/.


Installation
------------

Run "rake install" to install xmms2-scrobbler. The usual variables PREFIX
and DESTDIR are evaluated.

Alternatively, just copy the xmms2-scrobbler file anywhere you like.


Usage
-----

First, you need to store your Audioscrobbler username and password
in the config file:

	echo -e "user: foo\npassword: bar" > \
	        ~/.config/xmms2/clients/xmms2-scrobbler/config

Optionally, if you're behind a proxy, you'll need to tell XMMS2-Scrobbler
about that proxy:

	echo -e "proxy: my.proxy\nproxy_port: 8080" >> \
	        ~/.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.


Filters
-------

You can set up so called "submission filters" that will stop
XMMS2-Scrobbler from submitting songs with certain attributes.

XMMS2-Scrobbler ships with some filters in the filters/ directory.
They are also installed to PREFIX/share/xmms2-scrobbler/filters.

To enable a filter, copy the respective file to the
~/.config/xmms2/clients/xmms2-scrobbler/filters directory.
Alternatively, you can create a symlink.
Something went wrong with that request. Please try again.