Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
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