{"id":13834743,"url":"https://github.com/Oshan96/monkey-dl","last_synced_at":"2025-07-10T07:30:53.752Z","repository":{"id":39514479,"uuid":"242177795","full_name":"Oshan96/monkey-dl","owner":"Oshan96","description":"Bulk download your favourite anime episodes from your favourite anime websites","archived":false,"fork":false,"pushed_at":"2023-05-22T23:20:38.000Z","size":826,"stargazers_count":840,"open_issues_count":44,"forks_count":71,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-05-24T04:06:00.643Z","etag":null,"topics":["4anime","9anime","anime","anime-downloader","anime-fans","anime-scraper","anime-search","animepahe","animepahe-downloader","animeultima","ffmpeg","hls-downloader","monkey-dl","web-scraper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Oshan96.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-02-21T16:02:48.000Z","updated_at":"2025-05-22T17:20:14.000Z","dependencies_parsed_at":"2024-01-15T03:59:24.356Z","dependency_job_id":"287468b7-d331-45c8-9f3c-104d12851e00","html_url":"https://github.com/Oshan96/monkey-dl","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/Oshan96/monkey-dl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oshan96%2Fmonkey-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oshan96%2Fmonkey-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oshan96%2Fmonkey-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oshan96%2Fmonkey-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Oshan96","download_url":"https://codeload.github.com/Oshan96/monkey-dl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oshan96%2Fmonkey-dl/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264545157,"owners_count":23625403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["4anime","9anime","anime","anime-downloader","anime-fans","anime-scraper","anime-search","animepahe","animepahe-downloader","animeultima","ffmpeg","hls-downloader","monkey-dl","web-scraper"],"created_at":"2024-08-04T14:00:51.735Z","updated_at":"2025-07-10T07:30:53.092Z","avatar_url":"https://github.com/Oshan96.png","language":"Python","funding_links":[],"categories":["ANIME","Python"],"sub_categories":["Apps"],"readme":"![Banner](docs/images/banner.png)\u003cbr\u003e\n# Monkey-DL (Anime Downloader) [![Total Downloads](https://img.shields.io/github/downloads/Oshan96/Anime-Downloader/total.svg?style=for-the-badge)](https://github.com/Oshan96/Anime-Downloader/releases)\n\nYou can now bulk download your favourite anime episodes for various websites, in various resolutions, with or without filler episodes\n\n[See supported websites](#Supported-Websites)\n\n## Donations\nIf this project is helpful to you and love my work and feel like showing love/appreciation, would you like to buy me a coffee?\u003cbr\u003e\n\u003ca href=\"https://buymeacoff.ee/Oshan96\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" \u003e\u003c/a\u003e\n\n## Features\n* Download Anime from various [supported websites](#Supported-Websites)\n* Batch download episodes in the given range at once\n* High speed downloads\n* Download multiple episodes at once\n* Select the resolution (from the available resolutions for the website)\n* Select sub/dub (Check whether the website supports selective sub/dub downloads from [here](#Supported-Websites))\n* Choose whether filler episodes need to be downloaded or not by selecting \"Download fillers\" (By providing animefillerlist URL)\n* Name the files in \"Episode - {episode_number} - {episode_title}\" format by providing animefillerlist URL\n* Choose the directory files need to be downloaded into\n* Custom HLSDownloader (Now FFMPEG installation is optional from v1.0.4 upwards)\n* Custom decryptors for encrypted websites\n\n## Supported Websites\n\n#### Note\nAfter v1.0.4 release, Monkey-DL now uses a custom HLSDownloader to download from streams, which is over 10x faster than downloading from FFMPEG. FFMPEG is now optional to be installed in system. FFMPEG will only be used if there is any error occured. So for now, it is safe FFMPEG to be installed as well.\nFFMPEG dependency will be removed completely soon in a later release\n\n| Website                                       |Sub/Dub selection      | Need recaptcha token? | Supported resolutions                                         | FFMPEG needed?    | File Size                     | Additional Notes                                                                                  |\n|---                                            |---                    |---                    |---                                                            |---                |---                            |---                                                                                                |        \n| [9Anime](https://9anime.to/)                  | No                    | Yes                   | Default only                                                  | No                | 500-600MB                     | Will always work, provided token                                                                  |\n| [4Anime](https://4anime.to/)                  | No                    | No                    | Default only                                                  | No                | Around 150MB                  | Upon failure, visit 4anime website and restart anime downloader. Fastest downloads                |\n| [AnimePahe](https://animepahe.com/)           | No                    | No                    | 720p, 1080p                                                   | No                | 720p: ~150MB, 1080p: ~200MB   | 2captcha API key is needed to download from AnimePahe. Also download speed is capped by host      |\n| [Twist](https://twist.moe/)                   | No                    | No                    | 1080p                                                         | No                | 500MB+                        | Files are very high quality and fast downloads. Seems to be raw HorribleSub content               |\n| [AnimeFreak](https://www.animefreak.tv/)      | Yes                   | No                    | Default only                                                  | No                | ~90-100MB                     | Downloading from AnimeFreak is generally fast                                                     |\n| [GoGoAnime](https://gogoanime.io/)            | No                    | No                    | Mostly 360p, 480p                                             | Optional          | -                             | gogoanime.io and gogoanime.video are supported. gogoanime.pro support will be added in future     |\n| [AnimeUltima](https://www.animeultima.to/)    | Yes                   | No                    | Sub: 240p, 360p, 480p, 720p, 1080p\u003cbr\u003e\u003cbr\u003e Dub: Default only  | Optional          | 1080p is 1GB+                 | File sizes are relatively large                                                                   |\n| [AnimeFlix](https://animeflix.io/)            | Yes                   | No                    | Sub: 240p, 360p, 480p, 720p, 1080p\u003cbr\u003e\u003cbr\u003e Dub: Default only  | Optional          | 1080p is 1GB+                 | File sizes are relatively large                                                                   |\n\n## Download Anime Downloader [Windows]\n\u003e Note : Currently only windows executable is provided (Linux, Mac users go to [Build from source](#Building-from-source))\n\nDownload the [Latest Release](https://github.com/Oshan96/Anime-Downloader/releases) from here and extract the zip file\n\n## Downloading Your Favourite Anime\n\nFirst of all for websites which require capatcha token, Anime Downloader uses [2captcha](https://www.2captcha.com) to bypass google recaptcha, so you need to purchase one ([Check whether your anime website needs captcha token](#Supported-Websites))\n\nOpen settings.json and set [2captcha](https://2captcha.com/) API key in \"api_key\"\n\n```json\n\"api_key\":\"insert_2captcha_api_key\"\n```\n\n*Don't have 2captcha API key? Don't worry! You can still use this to download anime. Check the \"FAQ\" section on [how to download if you don't have a 2captcha API key](#Q---I-don't-have-a-2captcha-API-key,-is-there-any-workaround-for-that?)*\n\n##### In order to download from some websites (like animeultima.to) Anime Downloader requires you to have [FFMPEG](https://www.ffmpeg.org/) to be downloaded ([Check whether your anime website needs FFMPEG](#Supported-Websites))\n\n- You can download FFMPEG from [here](https://www.ffmpeg.org/download.html)\n- And then add the ffmpeg executable to system path\nOr, in your linux environment, \n```bash\nsudo apt install ffmpeg\n```\n\n#### Download failed and weird error came? Don't worry, it's because these websites are protected by various security measures. Simply, just visit the website manually, and restart the anime downloader!\n\n#### Still not able to download? Go ahead and post your issue [here](https://github.com/Oshan96/Anime-Downloader/issues). And I will look into the error and give necessary fixes!\n\n## Running the application\nNavigate to the extracted folder and open a cmd or powershell window from that folder and execute \"monkey-dl.exe\" from command line.\n\n## How to download using GUI version (v0.1.1-alpha upwards)\nIt is same as the CLI version, but provided a graphical user interface to collect necessary parameters.\n\nNote : After v1.0.4 and anove, Anime Downloader was named as \"Monkey-DL\" and the executable is called \"monkey-dl.exe\"\n\n* v1.0.4 and above:\n    Execute the \"monkey-dl.exe\" to start.\n\n* v1.0.3 and lower:\n    Execute the \"anime-dl.exe\" to start.\n\nIf you're running from source files, execute the \"anime-dl.py\" script\n\n```bash\npython3 ./anime-dl.py\n```\n\nAnd the GUI will appear as following :\n\n![GUI](docs/images/gui.png)\n\n#### Note : If you don't have a 2captcha API key, you need to [provide \"Recaptcha Token\" in the given text field](#Q---I-don't-have-a-2captcha-API-key,-is-there-any-workaround-for-that?) for websites require captcha token (check FAQ section)\n\n## How to download using anime-dl (CLI)?\n\nFirst of all, you need to be familiar with the commands you can use with the Anime Downloader.\n\n```\nCommands List :\n  -h, --help            show this help message and exit\n  -u, --url             9Anime.to URL for the anime to be downloaded\n  -n, --names           https://www.animefillerlist.com/ URL to retrieve episode titles\n  -d, --directory       Download destination. Will use the current directory if not provided\n  -s, --start           Starting episode\n  -e, --end             End episode\n  -c, --code            Recaptcha answer token code. Insert this if you don't have 2captcha captcha bypass api_key\n  -t, --threads         Number of parrallel downloads. Will download sequencially if not provided\n  -f, --filler          Whether fillers needed (True/False)\n```\nAbove mentioned are the arguments you should use in order to download anime. \n\n#### The below [FAQ](#FAQ) section provides examples on how to download anime using Anime Downloader\n\n## FAQ\n\n### Q - How can I download one piece anime episodes from 10 to 20?\n\n```bash\n./anime-dl.py -u https://9anime.to/watch/one-piece.ov8/169lyx -s 10 -e 20 -n https://www.animefillerlist.com/shows/one-piece \n```\n\nExplantion of the commands used : \n1) -u https://9anime.to/watch/one-piece.ov8/169lyx  : After the \"-u\" the 9anime.to url for one piece anime is provided\n2) -s 10    : start downloading from 10th episode (included)\n3) -e 20    : end downloading at 20th episode (included)\n4) -n https://www.animefillerlist.com/shows/one-piece   : Provide the animefillerlist.com url for one piece episodes list (this is required)\n\n### Q - How can I download one piece anime episodes 30 to 70 into \"D:\\Anime\\One Piece\" folder?\n\n```bash\n./anime-dl.py -u https://9anime.to/watch/one-piece.ov8/169lyx -s 30 -e 70 -n https://www.animefillerlist.com/shows/one-piece -d \"D:\\Anime\\One Piece\" \n```\n\nExplanation of commands : \n1) -d \"D:\\Anime\\One Piece\"  : Download the episodes into \"D:\\Anime\\One Piece\" folder\n\n### Q - How can I download bleach episodes 100 to 130 into \"D:\\Anime\\Bleach\" folder and download 4 episodes at once?\n\n```bash\n./anime-dl.py -u https://9anime.to/watch/bleach.6j9/lz7wvq -s 100 -e 130 -n https://www.animefillerlist.com/shows/bleach -d \"D:\\Anime\\Bleach\" -t 4\n```\n\nExplanation of commands : \n1) -t 4  : Perform 4 downloads at once\n\n### Q - How can I download bleach episodes 100 to 130 without filler episodes into \"D:\\Anime\\Bleach\" folder and download 3 episodes at once?\n\n```bash\n./anime-dl.py -u https://9anime.to/watch/bleach.6j9/lz7wvq -s 100 -e 130 -n https://www.animefillerlist.com/shows/bleach -d \"D:\\Anime\\Bleach\" -t 3 -f False\n```\n\nExplanation of commands : \n1) -f False  : Avoid downloading filler episodes in the given range (Default : True)\n\n### Q - I don't have a 2captcha API key, is there any workaround for that?\nAnswer : Yes ofcourse! If you don't have a 2captcha API key to bypass captcha, you can still download your favourite anime!\n*But how?*\nFollow these steps and you will be up and running in no time!\n\nLet's try it!\n\n\u003e Note : There was a bug in v0.0.2-alpha release regarding this solution, so please download v0.0.3-alpha\n\n\u003e Assumptions : let's assume you want to download bleach episodes as in the previous question\n\nSteps : \n1) Open a private window in the browser (ex: Google chrome)\n2) Go to the 9anime url (Bleach page) (https://9anime.to/watch/bleach.6j9/lz7wvq)\n3) Now the recaptcha will appear\n\n![recaptcha image](docs/images/recaptcha.png)\n\n4) Right click and open inspection mode (ctrl+shift+i for google chrome)\n\n![inspect window](docs/images/inspect.png)\n![inspect window2](docs/images/inspect2.png)\n\n5) Solve the recaptcha appeared on page (DO NOT SUBMIT!)\n\n![solve captcha](docs/images/solve.png)\n\n6) Find the captcha answer from the webpage using inspector\n\n![captcha answer](docs/images/answer.png)\n\nAnswer is the \"value\" of the \"input\" element with the id \"recaptcha-token\" (Find for element using this id using ctrl+f to find)\nCopy the \"value\" of the input tag\n\nSo the value/recpacha answer is :\n\n\u003ci\u003e\"03AERD8Xode9TV-gFkG-7CNkllpKoiXfDKVEZ0Lu9NjGpxVv89bjwNHkS5bcfXHqKXx746tsNW_IUMhSVV7Aym-lcvdn6jd5Ggy1a28AQ_BI1K380joLpYReKB0EOjJjO2oVEUpOgtPu0fgfjxABKpI9EjrDZ0T7iSsKDPfhnXebQcZxIbAwelADkZ8m4qYojn3J_-kQyreIRCEztWyTTpm_SoNt6lIpFxG-egDFqVF6Sg7ICPp0QQrPa5UC-6pecgs_3xspg7PN48VOXGfHH4PCARIaGVL-J5CYNsesqUuZ4t_4kni9euduhtB3KCrV1_IYOhymepwczWIKKPGmze2DKVddoDBABlS8NZaxHRFAzNjjJHOhlRyblBMlmerK_Mu5N25bZeY5ZZ\"\u003c/i\u003e\n\nNow we have what we need!\n\nAll you have to do is, add -c or --code command to the previous example's code like below\n\n```bash\n./anime-dl.py -u https://9anime.to/watch/bleach.6j9/lz7wvq -s 100 -e 130 -n https://www.animefillerlist.com/shows/bleach -d \"D:\\Anime\\Bleach\" -t 4 -f False -c 03AERD8Xode9TV-gFkG-7CNkllpKoiXfDKVEZ0Lu9NjGpxVv89bjwNHkS5bcfXHqKXx746tsNW_IUMhSVV7Aym-lcvdn6jd5Ggy1a28AQ_BI1K380joLpYReKB0EOjJjO2oVEUpOgtPu0fgfjxABKpI9EjrDZ0T7iSsKDPfhnXebQcZxIbAwelADkZ8m4qYojn3J_-kQyreIRCEztWyTTpm_SoNt6lIpFxG-egDFqVF6Sg7ICPp0QQrPa5UC-6pecgs_3xspg7PN48VOXGfHH4PCARIaGVL-J5CYNsesqUuZ4t_4kni9euduhtB3KCrV1_IYOhymepwczWIKKPGmze2DKVddoDBABlS8NZaxHRFAzNjjJHOhlRyblBMlmerK_Mu5N25bZeY5ZZ\n```\n\n### Recaptcha does not appear even in private browsing. What can I do?\n\nAnswer :\n\u003e Assumptions : let's assume you want to download bleach episodes as in the previous question\n\nThis can be solved in 2 steps.\n\n1) Run the anime-dl commands without -c/--code command (like you have a 2captcha key)\nThis will probably give error, but that's what we need.\n\n2) Now try loading the recaptcha page in private browsing. It will appear!\n\n### I'm getting the error \"No module named 'tkinter'\". How do I fix this?\n\nAnswer : \n\u003e Assumptions : you're trying to run the GUI on Ubuntu (or some other version of it, like Linux Mint)\n\nThis can be solved in 2 steps.\n\n1) Open a terminal and type in this command: `sudo apt install python3-tk`\n\n2) Enter your password (it will not be shown)\n\nIf the command doesn't work, you may need to run `sudo apt update` first then run the other command again. Once it's installed, the GUI should function correctly.\n\n## Building from source\n\n- Clone the project using to your local machine\n\n### Prerequisites\n\n- Make sure python 3.7+ (preferably the latest version) and pip3 is installed\n\n### Installing\n\n1) Download the dependancies using requirements.txt file\n\n```\npip install -r requirements.txt \n```\n2) Rename settings_example.json as settings.json\n\n3) Open settings.json and set [2captcha](https://2captcha.com/) API key in \"api_key\"\n\n```json\n\"api_key\":\"insert_2captcha_api_key\"\n```\n\n\u003e If you don't have a 2captcha API key purchased, check the \"FAQ\" section on [how to download if you don't have a 2captcha API key](#Q---I-don't-have-a-2captcha-API-key,-is-there-any-workaround-for-that?)\n\n## Usage\n\nAnime Downloader is a CLI application which takes command line arguments in execution time\n\nNote : The package structure has been changed and the source (working) directory is now \"anime_downloader/\"\n\nFirst change your working directory to \"anime_downloader/\" before running the script\n\n```bash\ncd /path/to/anime_downloader/\n```\n\nTo see the full available commands, run\n\n```bash\npython ./Anime_Downloader.py --help\n```\n\n```\nusage: Anime_Downloader.py [-h] -u \u003cURL\u003e -n \u003cTITLE_URL\u003e [-d \u003cDIR\u003e] [-s \u003cSTART\u003e]\n                           [-e \u003cEND\u003e] [-c \u003cTS_NO\u003e] [-t \u003cTHREADS\u003e] [-f \u003cISFILLER\u003e]\n\nAnime Downloader Command Line Tool\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -u, --url             9Anime.to URL for the anime to be downloaded\n  -n, --names           https://www.animefillerlist.com/ URL to retrieve episode titles\n  -d, --directory       Download destination. Will use the current directory if not provided\n  -s, --start           Starting episode\n  -e, --end             End episode\n  -c, --code            Recaptcha answer token code. Insert this if you don't have 2captcha captcha bypass api_key\n  -t, --threads         Number of parrallel downloads. Will download sequencially if not provided\n  -f, --filler          Whether fillers needed (True/False)\n\n```\n## Examples\n\nDownload One Piece episodes from 130 to 180 without filler episodes into \"K:\\Anime\\One-Piece\" folder with episode names (3 simultanious downloads a time)\n\n```bash\npython3 ./Anime_Downloader -u https://9anime.to/watch/one-piece.ov8/169lyx -s 130 -e 180 -f False -d \"F:\\Anime\\One-Piece\" -n https://www.animefillerlist.com/shows/one-piece -t 3\n```\n![Result](https://i.imgur.com/gRUhQdS.png)\n\n## Authors\n\n* **Oshan Mendis** - *Author* - [Oshan96](https://github.com/Oshan96)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n\n## Acknowledgements \nAnime Downloader wouldn't be possible without these awesome free and opensource projects!\n- [CloudScraper](https://github.com/VeNoMouS/cloudscraper)\n- [Js2Py](https://github.com/PiotrDabkowski/Js2Py)\n- [JsBeautifier](https://github.com/beautify-web/js-beautify)\n- [PyCryptodome](https://github.com/Legrandin/pycryptodome)\n- [PySimpleGUI](https://github.com/PySimpleGUI/PySimpleGUI)\n- [FFMPEG](https://ffmpeg.org/)\n\nSpecial thanks to [u/sln0913](https://www.reddit.com/user/sln0913) for the awesome logo and banner designs!\n\n## Disclaimer\n\nThis software has been developed only for educational purposes by the [Author](https://github.com/Oshan96). By no means this encourage content piracy. Please support original content creators!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOshan96%2Fmonkey-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOshan96%2Fmonkey-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOshan96%2Fmonkey-dl/lists"}