Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/anime-dl/anime-downloader

A simple but powerful anime downloader and streamer.
https://github.com/anime-dl/anime-downloader

9anime anime anime-downloader batch downloader episodes hacktoberfest kissanime nyaa

Last synced: about 1 month ago
JSON representation

A simple but powerful anime downloader and streamer.

Awesome Lists containing this project

README 

        
# Warning

## This project has been semi-abandoned, and it is in a non-working state, 
that might change in the future but for now please look at [related projects](#related-projects).




 









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?



![kawaii](https://thumbs.gfycat.com/IgnorantYoungDowitcher-size_restricted.gif)



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



## Features



- 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](https://aria2.github.io/) recommended).

- Configurable using `config.json`. See [documentation](https://anime-downlader.readthedocs.io/en/latest/usage/config.html).



## Supported Operating Systems:

- Windows

- Mac OS

- Linux

- Android

- iOS (requires Jailbreak and some tinkering)

  * Instructions for Mobile Operating Systems can be found in the [Installation Documentation Page](https://anime-downlader.readthedocs.io/en/latest/usage/installation.html)



## Supported Sites

**Details about the sites can be found in [FAQ](https://github.com/anime-dl/anime-downloader/wiki/FAQ)**



- AnimTime

- AnimeBinge

- Animeflv

- AnimeOnline360

- Animerush

- AnimeStar

- Animevibe

- Dbanimes

- EraiRaws

- EgyAnime - usually m3u8 (good for streaming, not so much for downloading)

- GenoAnime

- itsaturday

- Justdubs?

- KissanimeX

- Nyaa.si

- SubsPlease

- twist.moe - requires Node.js

- tenshi.moe

- Vidstream

- Vostfree

- Wcostream



Sites that require Selenium **DO NOT** and **WILL NOT** work on mobile operating systems



Twist.moe **DOES NOT** work and **WILL NOT** work on iOS, a specific Python module that is required for twist.moe is not supported on iOS and cannot be installed.



## Installation



[**Installation instructions***](https://anime-downlader.readthedocs.io/en/latest/usage/installation.html)



If you have trouble installing, see extended installation instructions [here](https://anime-downlader.readthedocs.io/en/latest/usage/installation.html) or join the [discord server](https://discord.gg/Qn2nWGm) for help.



**Note**:

- For Cloudflare scraping either [cfscrape](https://github.com/Anorov/cloudflare-scrape) or [selenium](https://www.selenium.dev/) is used. [Cfscrape](https://github.com/Anorov/cloudflare-scrape) depends on [`node-js`](https://nodejs.org/en/) and [selenium](https://www.selenium.dev/) 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](https://nodejs.org/en/) and a [webdriver](https://www.selenium.dev/selenium/docs/api/py/index.html#drivers) 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+https://github.com/anime-dl/anime-downloader#egg=anime_downloader[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+https://github.com/anime-dl/anime-downloader#egg=anime-downloader[unpacker]`



## Usage



See [docs](https://anime-downlader.readthedocs.io/en/latest/usage/dl.html).



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



- [dl](https://anime-downlader.readthedocs.io/en/latest/usage/dl.html): `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](https://anime-downlader.readthedocs.io/en/latest/usage/watch.html): `watch` can manage your anime watch list. Needs [mpv](https://mpv.io).

- [config](https://anime-downlader.readthedocs.io/en/latest/usage/config.html): 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](https://anime-downlader.readthedocs.io/en/latest/usage/api.html).



**Development Instructions:**



See [development instructions](https://anime-downlader.readthedocs.io/en/latest/advanced/custom_site.html).



## Related Projects



- [animdl](https://github.com/justfoolingaround/animdl) - a command-line tool for watching anime, it is maintained and in a better state than this project.

- [adl](https://github.com/RaitaroH/adl) - a command-line tool for watching anime that makes use of anime-downloader.

- [Cloudstream](https://github.com/LagradOst/CloudStream-2) - 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.*