twaddington / python-rdio-export

A tool for exporting an Rdio collection to a portable file format like markdown.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

python-rdio-export

This exporter can be used to backup the collection of an Rdio user. It includes a command-line utility script and a library for bundling into your own applications. The command-line utility will output results to stdout by default.

If you like this library and it's saved you some time, please consider supporting further development with a Gittip donation!

Requirements

  • requests
  • requests_oauthlib

Installing

$ pip install python-rdio-export

Authentication

You'll need to acquire API credentials from the Rdio developer site.

When using the command-line utility you can authenticate with Rdio one of three ways.

First, by providing your credentials to the command-line utility directly:

$ rdio-export --user twaddington --id your_client_id --secret your_client_secret

You can also (optionally) provide your Rdio credentials via two environment variables:

$ export RDIO_CLIENT_ID=your_client_id
$ export RDIO_CLIENT_SECRET=your_client_secret

You can also (optionally) provide your Rdio credentials via a global config file located in ~/.rdioconfig with the format:

[Rdio]
rdioClientId=your_client_key
rdioClientSecret=your_client_secret
Note: Credentials are parsed in the order listed above. For example, the script will first attempt to use credentials provided via the --id and --secret arguments. Next, credentials will be loaded from the environment variables. Finally, the config file will be examined for credentials.

Examples

Note: Results will be printed to stdout by default.

Export by username:

$ rdio-export --user twaddington

Export by email:

$ rdio-export --email tristan.waddington@gmail.com

Export to a file:

$ rdio-export --user twaddington > rdio-backup.txt

Bug reports

If you encounter any issues, please open a new issue on the project's GitHub page.

License

Copyright 2014 Tristan Waddington

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

A tool for exporting an Rdio collection to a portable file format like markdown.

License:Apache License 2.0


Languages

Language:Python 100.0%