Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

A library to interface with Crunchyroll's various APIs and utilites to work with the returned data

Project Description


Python interface to Crunchyroll's undocumented APIs and utilities
for working with the returned data. Eventual plan is to create a better
XMBC plugin.

### Requirements

* Python 2.6+
* requests
* tlslite

### Usage

Pretty much anything of interest is available now, including the RTMPE stream
data and decrypted and formatted subtitles.

Example usage:
>>> from crunchyroll.apis.meta import MetaApi
>>> api = MetaApi()
>>> pprint([ for s in api.list_anime_series(limit=5)])
[u'07 Ghost',
u'A Bridge to the Starry Skies - Hoshizora e Kakaru Hashi',
u'A Dark Rabbit has Seven Lives',
u'Abunai Sisters']
>>> space_brothers = api.search_anime_series('Space Brothers')[0]
>>> pprint(space_brothers.description)
u'To follow his brother Hibito to the moon, Mutta will attempt to become an
astronaut at the age of 32. Unaware of his own talent, Mutta chases his
dreams to get back in front of his younger brother.'
>>> sb_episodes = api.list_media(space_brothers)
>>> len(sb_episodes)
>>> ep = [e for e in sb_episodes if e.episode_number == '40'][0]
>>> print ep.episode_number,, ep.free_available
40 Heaven and Hell True
>>> api.login(username=username, password=password)
>>> stream = api.get_media_stream(ep)
>>> subs = stream.default_subtitles.decrypt().get_ass_formatted()
>>> print '\n'.join(subs.split('\n')[:9])
[Script Info]
Title: English (US)
ScriptType: v4.00+
WrapStyle: 0
PlayRexX: 704
PlayResY: 400
Subtitle ID: XXXXX
Language: English (US)
Created: 28 days ago
>>> [s.language for s in stream.subtitle_stubs]
['English (US)', u'Espa\xf1ol', u'Fran\xe7ais (France)', u'Portugu\xeas (Brasil)']
>>> fr_subs = api.unfold_subtitle_stub(stream.subtitle_stubs[2]).decrypt().get_srt_formatted()
>>> print '\n'.join(fr_subs.split('\n')[:11])
00:00:00,760 --> 00:00:02,940
Tiens ? Ça ne s'ouvre pas.

00:00:04,500 --> 00:00:06,770
Tourne le levier vers la gauche.

00:00:07,360 --> 00:00:10,150
Lequel ?

### Testing

Run the unit tests with:

$ python test

Note that some of the unit tests will use a CR account which should be made
available in the `CRUNCHYROLL_USERNAME` and `CRUNCHYROLL_PASSWORD` environment


This project is licensed under GPLv2+, see LICENSE for more details.

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
crunchyroll-1.0.1.tar.gz (18.3 kB) Copy SHA256 hash SHA256 Source None May 6, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page