2019-06-19 03:13:59 -07:00
< div align = "center" >
2020-07-28 09:54:42 -07:00
< img src = "https://i.imgur.com/7De34Nh.png" >
2019-06-19 03:13:59 -07:00
< br >
< strong > < i > A simple yet powerful tool for downloading anime.< / i > < / strong >
< br >
< br >
< a href = "https://travis-ci.com/vn-ki/anime-downloader" >
2019-07-12 10:41:36 -07:00
< img src = "https://img.shields.io/travis/com/vn-ki/anime-downloader.svg?style=for-the-badge&logo=Travis%20CI" >
2019-06-19 03:13:59 -07:00
< / a >
< a href = "https://codecov.io/gh/vn-ki/anime-downloader" >
2019-07-12 10:41:36 -07:00
< img src = "https://img.shields.io/codecov/c/github/vn-ki/anime-downloader.svg?logo=codecov&style=for-the-badge" >
2019-06-19 03:13:59 -07:00
< / a >
< a href = "https://pypi.org/project/anime-downloader/" >
2019-07-12 10:42:44 -07:00
< img src = "https://img.shields.io/pypi/v/anime-downloader.svg?logo=python&style=for-the-badge" >
2019-06-19 03:13:59 -07:00
< / a >
< a href = "https://discord.gg/Qn2nWGm" >
2019-07-12 10:41:36 -07:00
< img src = "https://img.shields.io/discord/483008720167632929.svg?color=%237289DA&label=Discord&logo=Discord&style=for-the-badge" >
< / a >
< a href = "https://anime-downlader.rtfd.io" >
< img src = "https://img.shields.io/readthedocs/anime-downlader.svg?logo=read%20the%20docs&style=for-the-badge" >
2019-06-19 03:13:59 -07:00
< / a >
< / div >
2019-07-12 10:41:36 -07:00
2020-03-20 10:32:30 -07:00
2019-06-19 03:13:59 -07:00
---
2020-03-20 10:32:30 -07:00
2018-02-04 15:33:18 -08:00
# Anime Downloader
2018-05-30 04:29:23 -07:00
Ever dreamt about watching anime for free effortlessly without all those unbearable ads? Ever dreamt of downloading your favourite anime for that long trip?
2018-05-29 12:30:59 -07:00
2018-06-05 16:42:16 -07:00
![kawaii ](https://thumbs.gfycat.com/IgnorantYoungDowitcher-size_restricted.gif )
2018-05-29 12:30:59 -07:00
Yeah. Me too! That's why this tool exists.
2018-02-04 15:33:18 -08:00
2018-05-30 04:26:10 -07:00
## Features
- Download or stream any episode or episode range of any anime.
2020-08-03 07:40:47 -07:00
- Have a locally stored anime list to track your progress and stream anime using the watch command.
2020-08-05 15:58:19 -07:00
- Import your MAL anime list to the local anime list.
2018-05-30 04:26:10 -07:00
- Specify the quality you want to stream or download.
2018-06-29 08:30:04 -07:00
- Search and download.
2018-05-30 04:26:10 -07:00
- Save yourselves from those malicious ads.
2018-06-29 08:30:04 -07:00
- Download using external downloader ([aria2](https://aria2.github.io/) recommended).
2020-03-27 05:47:22 -07:00
- Configurable using `config.json` . See [documentation ](https://anime-downlader.readthedocs.io/en/latest/usage/config.html ).
2020-03-20 10:32:30 -07:00
2020-07-14 13:18:11 -07:00
## 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 )
2018-06-01 06:09:18 -07:00
## Supported Sites
2020-04-20 13:47:48 -07:00
**Details about the sites can be found in [FAQ ](https://github.com/vn-ki/anime-downloader/wiki/FAQ )**
2020-07-20 15:04:47 -07:00
2020-07-31 10:14:28 -07:00
- 4Anime
2020-09-16 06:36:30 -07:00
- AnimeBinge
2020-08-30 05:08:38 -07:00
- Animedaisuki
2019-10-18 03:41:38 -07:00
- Animeflix
2020-03-06 13:26:09 -08:00
- Animeflv
2020-08-30 05:08:38 -07:00
- Animefreak
2020-07-20 15:04:47 -07:00
- AnimeKisa
2020-08-30 05:08:38 -07:00
- AnimeOnline360
- animeout
2020-04-01 08:52:31 -07:00
- Animerush
2020-08-30 05:08:38 -07:00
- Animesimple
2020-06-15 04:20:16 -07:00
- Animevibe
2020-10-03 05:31:10 -07:00
- AnimeTake
2020-10-08 07:18:46 -07:00
- AniTube
2020-08-30 05:08:38 -07:00
- Animixplay
- Anistream
2020-07-23 16:26:36 -07:00
- Darkanime
2020-09-16 06:42:56 -07:00
- Dbanimes
2020-10-12 17:09:08 -07:00
- EraiRaws
2020-12-28 14:32:25 -08:00
- EgyAnime - usually m3u8 (good for streaming, not so much for downloading)
2020-09-16 06:42:56 -07:00
- FastAni
2021-02-12 10:13:28 -08:00
- GenoAnime
2020-07-27 11:01:39 -07:00
- GurminderBoparai (AnimeChameleon)
2020-07-20 15:04:47 -07:00
- itsaturday
- Justdubs
2020-07-05 13:34:56 -07:00
- Kissanimefree
2020-08-23 04:07:54 -07:00
- KissanimeX
2020-07-20 15:04:47 -07:00
- Nyaa.si
2020-10-07 11:41:55 -07:00
- PutLockers
2020-07-20 15:04:47 -07:00
- RyuAnime
2021-01-27 06:39:59 -08:00
- Shiro.is
2020-10-31 05:08:23 -07:00
- SubsPlease
2020-07-20 15:04:47 -07:00
- twist.moe - requires Node.js
2020-09-16 06:35:50 -07:00
- tenshi.moe
2020-07-07 05:40:31 -07:00
- Vidstream
2020-08-30 05:08:38 -07:00
- Voiranime
- Vostfree
2018-06-21 07:43:01 -07:00
2020-07-20 15:04:47 -07:00
Sites that require Selenium **DO NOT** and **WILL NOT** work on mobile operating systems
2020-07-14 13:18:11 -07:00
2020-07-20 15:04:47 -07:00
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.
2020-07-14 13:18:11 -07:00
2018-02-04 15:33:18 -08:00
## Installation
2020-03-27 05:47:22 -07:00
[**Installation instructions*** ](https://anime-downlader.readthedocs.io/en/latest/usage/installation.html )
2018-06-01 12:13:27 -07:00
2020-03-27 05:47:22 -07:00
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.
2018-06-05 00:33:48 -07:00
2019-06-19 03:13:59 -07:00
**Note**:
2020-07-20 15:04:47 -07:00
- 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.
2018-06-03 06:07:51 -07:00
- You might have to use pip3 depending on your system
2020-10-17 13:01:36 -07:00
- 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 -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]`
2018-06-01 12:13:27 -07:00
2020-03-20 10:32:30 -07:00
## Usage
2018-02-04 15:33:18 -08:00
2020-03-27 05:47:22 -07:00
See [docs ](https://anime-downlader.readthedocs.io/en/latest/usage/dl.html ).
2018-02-04 15:33:18 -08:00
2020-10-16 15:30:06 -07:00
Anime Downloader has six (6) sub-commands, `dl` , `watch` , `gui` , `config` , `ezdl` and `test` .
2018-02-04 15:33:18 -08:00
2020-03-27 05:47:22 -07:00
- [dl ](https://anime-downlader.readthedocs.io/en/latest/usage/dl.html ): `dl` can download anime.
2020-10-14 17:09:47 -07:00
- ezdl: Uses metadata agents to unify providers and also auto select a result if the search argument is close to the anime title.
2020-08-05 17:38:15 -07:00
- [watch ](https://anime-downlader.readthedocs.io/en/latest/usage/watch.html ): `watch` can manage your anime watch list. Needs [mpv ](https://mpv.io ).
2020-10-14 17:09:47 -07:00
- [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.
2020-10-16 15:29:48 -07:00
- gui: opens a PyQT gui that allows for non commandline downloading and streaming.
2018-02-05 15:23:59 -08:00
2019-06-19 03:13:59 -07:00
**To use `anime_downloader` in your package:**
2018-05-29 12:30:59 -07:00
2020-07-20 15:04:47 -07:00
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.
2020-03-27 05:47:22 -07:00
See [documentation ](https://anime-downlader.readthedocs.io/en/latest/usage/api.html ).
2018-05-29 12:30:59 -07:00
2020-10-14 17:09:47 -07:00
2019-06-19 03:13:59 -07:00
**Development Instructions:**
2018-05-28 01:02:45 -07:00
2020-03-27 05:47:22 -07:00
See [development instructions ](https://anime-downlader.readthedocs.io/en/latest/advanced/custom_site.html ).
2018-05-28 01:02:45 -07:00
2019-10-23 01:15:24 -07:00
## Related Projects
- [adl ](https://github.com/RaitaroH/adl ) - a command-line tool for watching anime that makes use of anime-downloader.
2020-07-09 05:30:47 -07:00
- [Cloudstream ](https://github.com/LagradOst/CloudStream-2 ) - mobile gui for pirating anime and movies.
2019-10-23 01:15:24 -07:00
2018-06-26 06:41:48 -07:00
---
2018-05-27 11:10:41 -07:00
2020-08-21 07:23:45 -07:00
*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.*