anime-downloader/README.md

3.7 KiB

Anime Downloader

Build Status codecov PyPI pyversions

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

kawaii

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

Features

  • 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.

Supported Sites

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

Installation

You can install the stable release from PyPI.

$ pip install anime-downloader

To install the dev version

$ pip install -U git+https://github.com/vn-ki/anime-downloader.git

NOTE: You might have to use pip3 depending on your system

Cloudflare support is currently only available in master. Use the following command to install with cloudflare support.

pip install -U git+https://github.com/vn-ki/anime-downloader.git#egg=anime-downloader'[cloudflare]'

IMP: For cloudflare scraping cfscrape is used. It depends on node-js. So if you want to use cloudflare, make sure you have node installed.

Usage

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

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 😇) and you can select the desired result.

Download directly

  • To download Fullmetal Alchemist: Brotherhood all episodes
anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93'
  • To download Fullmetal Alchemist: Brotherhood episode 1
anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --episodes 1
  • To download Fullmetal Alchemist: Brotherhood episode 1 to 20
anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --episodes 1:21
  • To get stream url of Fullmetal Alchemist: Brotherhood episode 1.
anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --url --episodes 1
  • To play using vlc. (On windows use path to exe)
anime dl 'https://9anime.is/watch/fullmetal-alchemist-brotherhood.0r7/j69y93' --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 https://github.com/vn-ki/anime-downloader.git

# Run setup.py
$ 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

arigatou