Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Download your favourite anime

Project description

Anime Downloader

Build Status codecov PyPI pyversions PyPI

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.
  • Specify the quality you want to stream or download.
  • Search and download. (Only 9anime)
  • Save yourselves from those malicious ads.
  • Add any anime to your watch list using anime watch and let anime downloader take care of everything for you.
  • Configurable using config.json. See doc.

Supported Sites


  • 9anime
  • KissAnime [cloudflare]
  • KissCartoon [cloudflare]
  • Gogoanime


You can install the stable release from PyPI.

$ pip install anime-downloader

To install with cloudflare support,

$ pip install anime-downloader[cloudflare]

To install the dev version

$ pip install -U git+

# To install with cloudflare support
$ pip install -U git+[cloudflare]

If you have trouble installing, see extended installation instructions here.


  • For cloudflare scraping cfscrape is used. It depends on node-js. So if you want to use cloudflare, make sure you have node installed.
  • You might have to use pip3 depending on your system
  • If you are using zsh, don't forget to escape [ and ] using \.


Anime downloader has two sub commands, dl and watch. You can find the documentation in wiki

  • dl: dl can download anime.
  • watch: watch can manage your anime watching. Needs mpv. With watch you'll never have to go to any anime sites ever again.

Search and download

  • To search and download all episodes.
anime dl 'code geass'

NOTE: The above command shows the search results (which would fit you're terminal size :innocent:) and you can select the desired result.

Download directly

  • To download Fullmetal Alchemist: Brotherhood all episodes
anime dl ''
  • To download Fullmetal Alchemist: Brotherhood episode 1
anime dl '' --episodes 1
  • To download Fullmetal Alchemist: Brotherhood episode 1 to 20
anime dl '' --episodes 1:21
  • To get stream url of Fullmetal Alchemist: Brotherhood episode 1.
anime dl '' --url --episodes 1
  • To play using vlc. (On windows use path to exe)
anime dl '' --play vlc --episodes 1

To use anime_downloader in your package

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

Development Instructions

# Clone this repo
$ git clone

# Run
$ cd anime-downloader
$ pip install -e .

Please don't judge me for not paying for anime. I want to support these animation studios, but being a college student, I can't.

arigatou gozaimasu


Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


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
anime-downloader-2.6.2.linux-x86_64.tar.gz (36.5 kB) Copy SHA256 hash SHA256 Source None Jun 20, 2018
anime_downloader-2.6.2-py3-none-any.whl (22.3 kB) Copy SHA256 hash SHA256 Wheel py3 Jun 20, 2018

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