Skip to main content

Livestreamer stream dumper

Project description

Introduction

This program allows you to dump (a.k.a. ‘download’ or ‘save for later’) various streams/video sites like Dailymotion, YouTube, Twitch, Crunchyroll, and many more. It uses the livestreamer API so I don’t need to implement every new site by hand, and since the livestreamer API is very nice this makes the code lightweight and simple.

To run this program, you just need to call it like this:

$ livedumper_cli http://www.crunchyroll.com/fatekaleid-liner-prisma-illya/episode-1-illya-grow-up-657285 best

This will download a video called episode-1-illya-grow-up-657285.mp4 (sorry, no custom filenames yet) with the highest quality found by livestreamer in your current folder (you can change this passing the -d /path/to/folder option). You can download multiple files (unless you want different quality settings for each video) just calling the program with multiple URLs.

No options or anything like that yet. To login to some service, you can just use livestreamer command like:

$ livestreamer --crunchyroll-username=xxxx --crunchyroll-password=xxx http://www.crunchyroll.com/fatekaleid-liner-prisma-illya/episode-1-illya-grow-up-657285 best

How to install

You need to have both livestreamer and rtmpdump installed and added somewhere on your PATH. Probably the best way is to use your distribution packages to install this program. Since rtmpdump is a dependency of livestreamer your package manager should install both. Some distribution commands to install both:

$ sudo apt-get install livestreamer  Debian/Ubuntu and derivates
$ sudo pacman -S livestreamer  Arch Linux

After that you need to install livedumper per se. The easiest way to do it is using pip. This downloads and installs this project from PyPi, completely automagically (excluding for system dependencies). If you didn’t install livestreamer on the last step it will install for you (but probably without rtmpdump). Just run the following command:

$ sudo pip install livedumper

If you do want to install manually, you will first need to install the Python requirements. They’re listed on requirements.txt file, that is compatible with Python’s pip package manager. Just run the following commands:

$ sudo pip install -r requirements.txt
$ git clone https://github.com/m45t3r/crdown.git

Optional but recommended: instead of running the pip commands as root (using sudo) it’s better to create a isolated virtual environment so you don’t mess with your system Python. To do so, do the following:

$ sudo pip install virtualenv
$ virtualenv crdown
$ cd crdown
$ source bin/activate  You should run this command after every new terminal you open
$ pip install crdown

About Python versions

This program should be compatible both with Python 2.7.x and Python 3.2+, but is only tested in Python 3.4.x. Should something not work, if it’s in Python 2.7.x I may drop support depending if it’s too hard to fix. If it’s Python 3.2+ I will treat it as a bug so you can report and I will try to fix it.

Credits

This project is based on livestreamer. Thanks for all developers from livestreamer for the amazing API, it was a joy to work!

Project details


Release history Release notifications

History Node

0.3.1

History Node

0.3.0

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

This version
History Node

0.1

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
livedumper-0.1.tar.gz (4.8 kB) Copy SHA256 hash SHA256 Source None Aug 13, 2014

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