Skip to content
ampedandwired edited this page Jun 7, 2012 · 40 revisions

Rdio for XBMC allows you to play your Rdio music collection through the XBMC media centre.

Note: This addon is not yet general release. If you're not comfortable messing around with XBMC internals it's probably best to wait for the official release.

Installation

The addon is not available in any repositories yet, so for now it's a manual installation.

Install RTMP 2.4

This addon requires RTMP version 2.4. Ubuntu still ships with 2.3, and until recently so did XBMC Live, so you need to check your current version and upgrade if necessary.

Ubuntu (XBMC Live)

Open a shell and run the following command:

$ dpkg -s librtmp0 | grep -i version

This will print the version of the currently installed RTMP library. If the version begins with anything less than 2.4, you will need to upgrade. If it's 2.4 or greater you can skip this step.

If you need to upgrade, the XBMC ppa has a handy pre-built version of RTMP 2.4. To install it, open a shell and run the following commands:

$ sudo add-apt-repository ppa:team-xbmc
$ sudo apt-get update
$ RTMP_VERSION=`apt-cache madison rtmpdump | grep "team-xbmc" | grep "Packages" | cut -d '|' -f 2 | sed 's/ //g'`
$ sudo apt-get install librtmp0=$RTMP_VERSION rtmpdump=$RTMP_VERSION

Once you're done check the version by running $ dpkg -s librtmp0 | grep -i version again. You should see version that looks something like 2.4~20110711.gitc28f1bab-1ubuntu0~ppa1~oneiric1.

Windows

The install process for XBMC RTMP 2.4 on Windows is still to be tested. In the meantime there are a few threads about it on the web if you go googling.

Get an Rdio API Key

First off, if you don't already have a normal Rdio account, go sign up now.

In addition to your normal Rdio account, you will also need an Rdio API key. It only takes a few minutes to get one and it's free. Here's how you get one:

  1. Register for an Rdio API account
  2. Check your email click the link in the confirmation email to confirm your account
  3. In the page that pops up after confirming, click the "Apply for access to use the API" link. This will bring up the "Rdio Application Registration" form.
  4. In the "Rdio Application Registration" form, enter "rdio-xbmc" for "Name of your application". Make sure "Issue a new key for rdio API" is checked, agree to the terms of service, then click "Register Application"
  5. The next page will show your API "Key" and "Shared Secret". Make a note of these - you'll need them later.

Install the Rdio XBMC Add-on

  1. Get the latest download from https://github.com/ampedandwired/rdio-xbmc/downloads and put it into a directory that is accessible from XBMC
  2. In XBMC, go to "System > Settings > Add-ons > Install from zip fIle" and install the add-on from where you downloaded it in the previous step. There is a brief tutorial on installing an add-on from a zip on the XBMC wiki.
  3. Go to "Music > Add-ons" and you should see the Rdio add-on.

Configure the Rdio XBMC Add-on

  1. Open the Rdio add-on and choose "Settings". Enter your Rdio username/password and the Rdio "API Key" and API "Shared Secret" that you obtained earlier.
  2. After saving your settings, choose "Login" from the add-on menu. After 15 seconds or so you should see menus allowing you to browse and play your Rdio music collection.

Problems?

This add-on is still pre-release so there's bound to be bugs and other issues. If you're having problems installing or using the add-on, post a question on the XBMC forum thread for this addon.

If you think you've found a bug, raise an issue in the github issue tracker.

Credits

Thanks to Peter Griess for deciphering the undocumented Rdio flash API.

Clone this wiki locally