Skip to main content

Download your favourite anime

Project description

A simple yet powerful tool for downloading anime.

Anime Downloader

Ever dreamt about watching anime for free effortlessly without all those unbearable ads? Ever dreamt of downloading your favourite anime for that long trip?


Yeah. Me too! That's why this tool exists.


  • Download or stream any episode or episode range of any anime.
  • Have a locally stored anime list to track your progress and stream anime using the watch command.
  • Import your MAL anime list to the local anime list.
  • Specify the quality you want to stream or download.
  • Search and download.
  • Save yourselves from those malicious ads.
  • Download using external downloader (aria2 recommended).
  • Configurable using config.json. See documentation.

Supported Operating Systems:

  • Windows
  • Mac OS
  • Linux
  • Android
  • iOS (requires Jailbreak and some tinkering)

Supported Sites

Details about the sites can be found in FAQ

  • 4Anime - requires jsbeautifier
  • AnimeBinge
  • Animedaisuki
  • Animeflix
  • Animeflv
  • Animefreak
  • AnimeKisa
  • AnimeOnline360
  • animeout
  • Animerush
  • Animesimple
  • Animevibe
  • AnimeTake
  • AniTube
  • Animixplay
  • Anistream
  • Darkanime
  • Dbanimes
  • EraiRaws
  • EgyAnime - usually m3u8 (good for streaming, not so much for downloading)
  • GenoAnime
  • GurminderBoparai (AnimeChameleon)
  • itsaturday
  • Justdubs
  • Kissanimefree
  • KissanimeX
  • PutLockers
  • RyuAnime
  • SubsPlease
  • - requires Node.js
  • Vidstream
  • Voiranime
  • Vostfree

Sites that require Selenium DO NOT and WILL NOT work on mobile operating systems DOES NOT work and WILL NOT work on iOS, a specific Python module that is required for is not supported on iOS and cannot be installed.


Installation instructions*

If you have trouble installing, see extended installation instructions here or join the discord server for help.


  • For Cloudflare scraping either cfscrape or selenium is used. Cfscrape depends on node-js and selenium utilizes an automated invisible instance of a browser (chrome/firefox). So, if you want to use Cloudflare enabled sites, make sure you have node-js and a webdriver installed.
  • You might have to use pip3 depending on your system
  • To install this project with gui and all its dependencies, add #egg=anime-downloader[gui] to the pip command you are using to install it. Example: pip install --force-reinstall -U git+[gui]
  • To install this project with selescrape (if you are using GUI, ignore this line), do the same as above - but with #egg=anime-downloader[selescrape]
  • To install this project with jsbeautifier run pip install --force-reinstall -U git+[unpacker]


See docs.

Anime Downloader has six (6) sub-commands, dl, watch, gui, config, ezdl and test.

  • dl: dl can download anime.
  • ezdl: Uses metadata agents to unify providers and also auto select a result if the search argument is close to the anime title.
  • watch: watch can manage your anime watch list. Needs mpv.
  • config: can manage the configuration for anime dl.
  • test: Tests all the providers, not the most reliable command as the results may be faulty.
  • gui: opens a PyQT gui that allows for non commandline downloading and streaming.

To use anime_downloader in your package:

This tool can be used as a library. This means you can import it into your own applications and search for anime and do many other wonderful things. See documentation.

Development Instructions:

See development instructions.

Related Projects

  • adl - a command-line tool for watching anime that makes use of anime-downloader.
  • Cloudstream - mobile gui for pirating anime and movies.

Please bear in mind the production of this repo is for educational/research purposes only with regards to webscraping for videos, we take no responsibility for people who decide to actually use this repository.

Project details

Download files

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

Files for anime-downloader, version 5.0.9
Filename, size File type Python version Upload date Hashes
Filename, size anime_downloader-5.0.9-py3-none-any.whl (136.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size anime-downloader-5.0.9.tar.gz (91.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page