Crunchyroll video downloader.
This is somewhat both a port and cleanup of Crunchyroll Downloader Toolkit DX for Unix systems. Actually, it still should work on Windows too, but since compiling things using pip is not the easiest thing on Windows, if you do want to use this on Windows it’s easier to just use Crunchyroll Downloader Toolkit DX.
It’s really simple to use. First you need to login to your account, using the following command:
$ crdown -l
This will generate a ‘cookies.txt’ file in your configuration directory (generally ~/.config/crdown), containing you account information. Even if you don’t have a account you need to run this command at least once to generate a valid ‘cookies.txt’ file.
$ crdown http://www.crunchyroll.com/fatekaleid-liner-prisma-illya/episode-1-illya-grow-up-657285
You can change some settings (like video quality, subtitle language, etc.) creating a ‘settings.ini’ in your configuration directory. See misc/settings.ini file for an example.
That’s it. You will see .flv and .ass files (if the subtitle is available) in the ./export/ directoy if all goes well. If you want to convert the .flv/.ass files in a nicer .mkv container, you will need some additional tools (see “How to install” section) to do the job. See misc/convert.sh script for an example on how to convert files.
WARNING: for now this script will delete the original .flv/.ass files. You can comment the line on ‘convert.sh’ script that do it if you don’t want this behavior.
How to install
You need to have ‘rtmpdump’ installed and added somewhere on your PATH. Probably the best way is to use your distribution packages to install this program. Some distribution commands to install ‘rtmpdump’:
$ sudo apt-get install rtmpdump Debian/Ubuntu and derivates $ sudo pacman -S rtmpdump Arch Linux
Alternatively, you can change the option rtmpdump_path in ‘settings.ini’. See misc/settings.ini for details.
After that you need to install ‘crdown’ 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). The only problem it’s not always up-to-date. Just run the following command:
$ sudo pip install crdown
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, install the python-virtualenv package and do the following:
$ virtualenv crdown $ cd crdown $ source bin/activate You should run this command after every new terminal you open $ pip install crdown
Aditional dependencies to ‘convert.sh’ script: you will need ‘ffmpeg’ and ‘mkvtoolnix’ installed to run the MKV conversion script. Some distribution commands to install both:
$ sudo apt-get install ffmpeg mkvtoolnix Debian/Ubuntu and derivates $ sudo pacman -S ffmpeg mkvtoolnix Arch Linux
Copy misc/convert.sh somewhere and make the changes to adapt to your case. The script serves as an example only, do not run it without studying what it does.
About Python versions
This program is only compatible with Python 3.x. It’s only tested on Python 3.4.x but should work with anything newer than Python 3.2 (if it doesn’t please report; if it’s not difficult I will fix it). An older version, compatible with Python 2.7 (but not compatible with Python 3.x series) is available in branch python2.
Speaking of version numbers, any version <0.6 is Python 2.7 only, while versions >=0.6 is Python 3.2+ only.
This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License. To view a copy of this license, visit this page or see the included LICENSE.txt file.
The software is provided “AS IS”, without any warranty, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The author(s) will not be liable for any special, incidental, consequential or indirect damages due to loss of data or any other reason. This is a free tool for educational (yes, educational >.>) use only.
This project is based on Crunchyroll Downloader Toolkit DX from einstein95, with some modifications and removal of any specific Windows features (like use of ‘.bat’ files, hardcoded program paths and inclusion of binary .exe programs on the package). Thanks einstein95 for making this program possible!
A list containing the credits from the original project can be found on this forum post. Probably they all helped this project in one way or another, so thanks for all of them too!