Clone this wiki locally
Requires Kodi 14.0 "Gotham" or better.
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:
- Register for an Rdio API account
- Check your email and click the link in the confirmation email to confirm your account
- 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.
- In the "Rdio Application Registration" form, enter "rdio-kodi" 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"
- The next page will show your API "Key" and "Shared Secret". Make a note of these - you'll need them later.
Install the Rdio Kodi Add-on
The Rdio Kodi plugin is available through the official Kodi addons repository. Install it through the Kodi UI as you would any other addon.
Configure the Rdio Kodi Add-on
- 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.
- 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 Kodi 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 Kodi version
- Your platform (XBOX/Linux/Windows/Mac/ATV)
OpenElec 5.0 Errors
OpenElec 5.0 doesn't ship with a version of distutils which is required by the OAuth2 Python module that this plugin uses, and this causes the plugin to fail when logging in. It's not clear at the moment what the best fix is. As this is an OpenElec issue and not an issue with this plugin per se, it's probably best to seek help through OpenElec support channels. These links may be of assistance:
Playback not working
One possible cause is that your Kodi 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 Kodi Live, so you need to check your current version and upgrade if necessary.
Ubuntu (Kodi 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 Kodi 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
Download this librtmp somewhere where your Kodi installation can see it.
Use Cyberduck or PuTTy, and connect to your Kodi device.
Navigate to /private/var/stash/Applications.m7LFCH/XBMC.app/Frameworks (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 Kodi 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.
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:
- Firstly check, recheck and triple check the user ID's and passwords that you entered in the plugin
- Verify that your account isn't locked and that your credentials worked by logging in with them through the standard Rdio web interface
- 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).
- Open the file
<kodi_home>/userdata/addon_data/plugin.audio.rdio/settings.xml. 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.
- If all else fails ask on the forum.