/Anime-Downloader

Bulk download your favourite anime episodes from your favourite anime websites

Primary LanguagePythonMIT LicenseMIT

Anime Downloader Total Downloads

You can now bulk download your favourite anime episodes for various websites, in various resolutions, with or without filler episodes

See supported websites

Donations

If this project is helpful to you and love my work and feel like showing love/appreciation, would you like to buy me a coffee? Buy Me A Coffee

Supported Websites

Website Need recaptcha token? Supported resolutions FFMPEG needed?
9Anime Yes Default only No
4Anime No Default only No
AnimePahe No 720p, 1080p No
AnimeUltima No 240p, 360p, 480p, 720p, 1080p Yes

Download Anime Downloader [Windows]

Note : Currently only windows executable is provided (Linux, Mac users go to Build from source)

Download the Latest Relase from here and extract the zip file

Downloading Your Favourite Anime

First of all for websites which require capatcha token, Anime Downloader uses 2captcha to bypass google recaptcha, so you need to purchase one (Check whether your anime website needs captcha token)

Open settings.json and set 2captcha API key in "api_key"

"api_key":"insert_2captcha_api_key"

Don't have 2captcha API key? Don't worry! You can still use this to download anime. Check the "FAQ" section on how to download if you don't have a 2captcha API key

And in order to download from some websites (like animeultima.to) Anime Downloader requires you to have FFMPEG to be downloaded (Check whether your anime website needs FFMPEG)
  • You can download FFMPEG from here
  • And then add the ffmpeg executable to system path Or, in your linux environment,
sudo apt install ffmpeg

Download failed and weird error came? Don't worry, it's because these websites are protected by various security measures. Simply, just visit the website manually, and restart the anime downloader!

Still not able to download? Go ahead and post your issue here. And I will look into the error and give necessary fixes!

Running the application

Navigate to the extracted folder and open a cmd or powershell window from that folder and execute "anime-dl.exe" from command line.

How to download using GUI version (v0.1.1-alpha upwards)

It is same as the CLI version, but provided a graphical user interface to collect necessary parameters.

Execute the "anime-dl.exe" to start.

If you're running from source files, execute the "anime-dl.py" script

python3 ./anime-dl.py

And the GUI will appear as following :

GUI

Note : If you don't have a 2captcha API key, you need to provide "Recaptcha Token" in the given text field for websites require captcha token (check FAQ section)

How to download using anime-dl (CLI)?

First of all, you need to be familiar with the commands you can use with the Anime Downloader.

Commands List :
  -h, --help            show this help message and exit
  -u, --url             9Anime.to URL for the anime to be downloaded
  -n, --names           https://www.animefillerlist.com/ URL to retrieve episode titles
  -d, --directory       Download destination. Will use the current directory if not provided
  -s, --start           Starting episode
  -e, --end             End episode
  -c, --code            Recaptcha answer token code. Insert this if you don't have 2captcha captcha bypass api_key
  -t, --threads         Number of parrallel downloads. Will download sequencially if not provided
  -f, --filler          Whether fillers needed (True/False)

Above mentioned are the arguments you should use in order to download anime.

The below FAQ section provides examples on how to download anime using Anime Downloader

FAQ

Q - How can I download one piece anime episodes from 10 to 20?

./anime-dl.exe -u https://9anime.to/watch/one-piece.ov8/169lyx -s 10 -e 20 -n https://www.animefillerlist.com/shows/one-piece

Explantion of the commands used :

  1. -u https://9anime.to/watch/one-piece.ov8/169lyx : After the "-u" the 9anime.to url for one piece anime is provided
  2. -s 10 : start downloading from 10th episode (included)
  3. -e 20 : end downloading at 20th episode (included)
  4. -n https://www.animefillerlist.com/shows/one-piece : Provide the animefillerlist.com url for one piece episodes list (this is required)

Q - How can I download one piece anime episodes 30 to 70 into "D:\Anime\One Piece" folder?

./anime-dl.exe -u https://9anime.to/watch/one-piece.ov8/169lyx -s 10 -e 20 -n https://www.animefillerlist.com/shows/one-piece -d "D:\Anime\One Piece"

Explanation of commands :

  1. -d "D:\Anime\One Piece" : Download the episodes into "D:\Anime\One Piece" folder

Q - How can I download bleach episodes 100 to 130 into "D:\Anime\Bleach" folder and download 4 episodes at once?

./anime-dl.exe -u https://9anime.to/watch/bleach.6j9/lz7wvq -s 100 -e 130 -n https://www.animefillerlist.com/shows/bleach -d "D:\Anime\Bleach" -t 4

Explanation of commands :

  1. -t 4 : Perform 4 downloads at once

Q - How can I download bleach episodes 100 to 130 without filler episodes into "D:\Anime\Bleach" folder and download 3 episodes at once?

./anime-dl.exe -u https://9anime.to/watch/bleach.6j9/lz7wvq -s 100 -e 130 -n https://www.animefillerlist.com/shows/bleach -d "D:\Anime\Bleach" -t 3 -f False

Explanation of commands :

  1. -f False : Avoid downloading filler episodes in the given range (Default : True)

Q - I don't have a 2captcha API key, is there any workaround for that?

Answer : Yes ofcourse! If you don't have a 2captcha API key to bypass captcha, you can still download your favourite anime! But how? Follow these steps and you will be up and running in no time!

Let's try it!

Note : There was a bug in v0.0.2-alpha release regarding this solution, so please download v0.0.3-alpha

Assumptions : let's assume you want to download bleach episodes as in the previous question

Steps :

  1. Open a private window in the browser (ex: Google chrome)
  2. Go to the 9anime url (Bleach page) (https://9anime.to/watch/bleach.6j9/lz7wvq)
  3. Now the recaptcha will appear

recaptcha image

  1. Right click and open inspection mode (ctrl+shift+i for google chrome)

inspect window inspect window2

  1. Solve the recaptcha appeared on page (DO NOT SUBMIT!)

solve captcha

  1. Find the captcha answer from the webpage using inspector

captcha answer

Answer is the "value" of the "input" element with the id "recaptcha-token" (Find for element using this id using ctrl+f to find) Copy the "value" of the input tag

So the value/recpacha answer is :

"03AERD8Xode9TV-gFkG-7CNkllpKoiXfDKVEZ0Lu9NjGpxVv89bjwNHkS5bcfXHqKXx746tsNW_IUMhSVV7Aym-lcvdn6jd5Ggy1a28AQ_BI1K380joLpYReKB0EOjJjO2oVEUpOgtPu0fgfjxABKpI9EjrDZ0T7iSsKDPfhnXebQcZxIbAwelADkZ8m4qYojn3J_-kQyreIRCEztWyTTpm_SoNt6lIpFxG-egDFqVF6Sg7ICPp0QQrPa5UC-6pecgs_3xspg7PN48VOXGfHH4PCARIaGVL-J5CYNsesqUuZ4t_4kni9euduhtB3KCrV1_IYOhymepwczWIKKPGmze2DKVddoDBABlS8NZaxHRFAzNjjJHOhlRyblBMlmerK_Mu5N25bZeY5ZZ"

Now we have what we need!

All you have to do is, add -c or --code command to the previous example's code like below

./anime-dl.exe -u https://9anime.to/watch/bleach.6j9/lz7wvq -s 100 -e 130 -n https://www.animefillerlist.com/shows/bleach -d "D:\Anime\Bleach" -t 4 -f False -c 03AERD8Xode9TV-gFkG-7CNkllpKoiXfDKVEZ0Lu9NjGpxVv89bjwNHkS5bcfXHqKXx746tsNW_IUMhSVV7Aym-lcvdn6jd5Ggy1a28AQ_BI1K380joLpYReKB0EOjJjO2oVEUpOgtPu0fgfjxABKpI9EjrDZ0T7iSsKDPfhnXebQcZxIbAwelADkZ8m4qYojn3J_-kQyreIRCEztWyTTpm_SoNt6lIpFxG-egDFqVF6Sg7ICPp0QQrPa5UC-6pecgs_3xspg7PN48VOXGfHH4PCARIaGVL-J5CYNsesqUuZ4t_4kni9euduhtB3KCrV1_IYOhymepwczWIKKPGmze2DKVddoDBABlS8NZaxHRFAzNjjJHOhlRyblBMlmerK_Mu5N25bZeY5ZZ

Recaptcha does not appear even in private browsing. What can I do?

Answer :

Assumptions : let's assume you want to download bleach episodes as in the previous question

This can be solved in 2 steps.

  1. Run the anime-dl commands without -c/--code command (like you have a 2captcha key) This will probably give error, but that's what we need.

  2. Now try loading the recaptcha page in private browsing. It will appear!

I'm getting the error "No module named 'tkinter'". How do I fix this?

Answer :

Assumptions : you're trying to run the GUI on Ubuntu (or some other version of it, like Linux Mint)

This can be solved in 2 steps.

  1. Open a terminal and type in this command: sudo apt install python3-tk

  2. Enter your password (it will not be shown)

If the command doesn't work, you may need to run sudo apt update first then run the other command again. Once it's installed, the GUI should function correctly.

Building from source

  • Clone the project using to your local machine

Prerequisites

  • Make sure python 3.7+ (preferably the latest version) and pip3 is installed

Installing

  1. Download the dependancies using requirements.txt file
pip install -r requirements.txt

  1. Rename settings_example.json as settings.json

  2. Open settings.json and set 2captcha API key in "api_key"

"api_key":"insert_2captcha_api_key"

If you don't have a 2captcha API key purchased, check the "FAQ" section on how to download if you don't have a 2captcha API key

Usage

Anime Downloader is a CLI application which takes command line arguments in execution time

Note : The package structure has been changed and the source (working) directory is now "anime_downloader/"

First change your working directory to "anime_downloader/" before running the script

cd /path/to/anime_downloader/

To see the full available commands, run

python ./Anime_Downloader.py --help
usage: Anime_Downloader.py [-h] -u <URL> -n <TITLE_URL> [-d <DIR>] [-s <START>]
                           [-e <END>] [-c <TS_NO>] [-t <THREADS>] [-f <ISFILLER>]

Anime Downloader Command Line Tool

optional arguments:
  -h, --help            show this help message and exit
  -u, --url             9Anime.to URL for the anime to be downloaded
  -n, --names           https://www.animefillerlist.com/ URL to retrieve episode titles
  -d, --directory       Download destination. Will use the current directory if not provided
  -s, --start           Starting episode
  -e, --end             End episode
  -c, --code            Recaptcha answer token code. Insert this if you don't have 2captcha captcha bypass api_key
  -t, --threads         Number of parrallel downloads. Will download sequencially if not provided
  -f, --filler          Whether fillers needed (True/False)

Examples

Download One Piece episodes from 130 to 180 without filler episodes into "K:\Anime\One-Piece" folder with episode names (3 simultanious downloads a time)

python3 ./Anime_Downloader -u https://9anime.to/watch/one-piece.ov8/169lyx -s 130 -e 180 -f False -d "F:\Anime\One-Piece" -n https://www.animefillerlist.com/shows/one-piece -t 3

Result

Authors

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgements

Anime Downloader wouldn't be possible without these awesome free and opensource projects!

Disclaimer

This software has been developed only for educational purposes by the Author. By no means this encourage content piracy. Please support original content creators!