tunigo 1.0.0

Python API for the browse feature of Spotify

Python-Tunigo is a python package that allows for simple access to Tunigo’s API. This is an API for fetching featured playlists and new releases for Spotify. It supports featured playlists, top playlists, new album releases and playlists for a range of different genres.

Tunigo’s API is what the Spotify client uses to provide its Browse-feature.

Note that the API is not documented or officially released, so it may change at any time.

Installation

Debian/Ubuntu/Raspbian: Install the python-tunigo or the python3-tunigo package from apt.mopidy.com:

sudo apt-get install python-tunigo
sudo apt-get install python3-tunigo

Arch Linux: Install the python2-tunigo or the python-tunigo package from AUR, e.g.:

yaourt -S python2-tunigo
yaourt -S python-tunigo

Else: Install the tunigo package from PyPI:

pip install tunigo

Examples

import tunigo
tunigo = tunigo.Tunigo()
for playlist in tunigo.get_featured_playlists():
    print(playlist.title)

See the examples/ directory for further examples.

License

Python-Tunigo is licensed under the Apache License, Version 2.0.

Project resources

• Source code
• Issue tracker
• Download development snapshot

Changelog

v1.0.0 (2016-02-07)

• Add support for specifying a proxy to use.
• Don’t specify region in API call if not given. (Fixes: #2)
• Add the new field Release.artist_uri.
• Fix type of Release.created to be int all places.
• Add tests for all classes.

v0.1.3 (2014-11-29)

• Fix check for content-type so it doesn’t fail after a change in the API.

v0.1.2 (2014-08-03)

• Fix that some genres were not listed by using the same query options as play.spotify.com.

v0.1.1 (2014-07-21)

• Allow Genre- and SubGenre-objects as arguments to get_genre_playlists.
• Allow a SubGenre to be created with main_genre as a string.
• Add __repr__ and __str__ methods to classes.

v0.1.0 (2014-06-24)

• Initial release.