Skip to content
This repository

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


Note: This plugin has only been tested on XBMC 11.0 Eden and up. Versions prior to this are not supported.

Note: The plugin is currently broken for new users due to changes in the rdio website. Existing users who have already authenticated can continue to use the plugin. New users, or anyone using the re-authenticate option will not be able to log in. More information here

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 and 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

The Rdio add-on is available from ampedandwired add-on repository.

The easiest way to add this repository to your XBMC installation is to use the XBMC Repositories Installer (have a look at this video if you're not familiar with installing and using the Repositories Installer). Once you have added the ampedandwired add-on repository, you should be able to install the Rdio addon from the usual "Music > Add-ons > Get more..." menu.

If you'd prefer to add the repository manually, you can install from the latest ampedandwired repository zip.

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.


If you're having problems installing or using the add-on, first have a look through some of the troubleshooting sections below. If you're still having problems, post a question on the XBMC forum thread for this addon.

If you think you've found a bug or if you have a feature request, raise an issue in the github issue tracker. When reporting a bug make sure that you include the following with your bug report:

  • A debug log
  • A description of how to reproduce the bug
  • Your XBMC version
  • Your platform (XBOX/Linux/Windows/Mac/ATV)

Playback not working (Eden)

The most likely cause is that your XBMC installation is using an old version of RTMP. This addon requires at least 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.

Apple TV

Download this librtmp somewhere where your XBMC installation can see it.

Use Cyberduck or PuTTy, and connect to your XBMC device.

Navigate to /private/var/stash/Applications.m7LFCH/ (Note that depending on your device and firmware version, your Applications folder may be labeled slightly differently)

Copy the librtmp.0.dylib file you downloaded above, to the Frameworks folder. Overwrite the current one (you may want to make a backup just in case).

Completely reboot the device.


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.

Authentication Fails

There seems to be a bug with certain setups that causes the entered user ID's and passwords to be saved incorrectly in some situations. This is still under investigation, but it seems that it could be caused by the iOS remote control application adding extra characters when entering the passwords. In the meantime if you have problems with the plugin authenticating to Rdio, follow these steps:

  1. Firstly check, recheck and triple check the user ID's and passwords that you entered in the plugin
  2. Verify that your account isn't locked and that your credentials worked by logging in with them through the standard Rdio web interface
  3. If you entered the user ID's and passwords using the iOS remote control application (eg: on iPhone or iPad), then try entering the details using a different method (eg: a keyboard or mouse).
  4. Open the file <xbmc_home>/userdata/addon_data/ Check that the values in that file match your usernames and passwords. In particular, look for erroneous spaces before/after the "value" fields in this file.
  5. If all else fails ask on the forum.

Playback doesn't work on Frodo

There is a known problem with playback on Frodo RC3. It will be fixed in Frodo Final, but if you want to use RC3 there is a workaround. Create a file <xbmc_home>/userdata/playercorefactory.xml with the following content:

  <rules name="system rules">
    <rule name="rtmpe" protocols="rtmpe" player="DVDPlayer" />

Save this file, make sure the permissions are correct for XBMC to be able to read the file and restart XBMC.


Thanks to Peter Griess for deciphering the undocumented Rdio flash API (note, Rdio have added extra security to this API, so the code in Peter's original blog post no longer works).

Something went wrong with that request. Please try again.