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.

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

Usage

Run anime-dl --help for help text.

$ anime-dl --help
Usage: anime-dl [OPTIONS] ANIME_URL

  Anime Downloader

  Download your favourite anime.

Options:
  -e, --episodes <int>:<int>      Range of anime you want to download in the
                                  form <start>:<end>
  -p, --save-playlist             If flag is set, saves the stream urls in an
                                  m3u file instead of downloading
  -u, --url                       If flag is set, prints the stream url
                                  instead of downloading
  --play PLAYER                   Streams in the specified player
  --no-download                   Retrieve without downloading
  -q, --quality [360p|480p|720p]  Specify the quality of episode. Default-720p
  -f, --force                     Force downloads even if file exists
  -ll, --log-level [DEBUG|INFO|WARNING|ERROR]
                                  Sets the level of logger
  --help                          Show this message and exit.

You can use this tool to search and download or download directly from the url.

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 .

TODO

  • Support for more sites

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

arigato