{"id":20391104,"url":"https://github.com/aditya76-git/zoro-dl","last_synced_at":"2025-04-12T11:22:29.187Z","repository":{"id":191529225,"uuid":"684846077","full_name":"aditya76-git/zoro-dl","owner":"aditya76-git","description":"ZORO-DL -🔥A Python Package to Download Anime from ZORO [DUAL AUDIO] [MULTI SUBS]","archived":false,"fork":false,"pushed_at":"2023-11-13T06:34:20.000Z","size":13157,"stargazers_count":5,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-12-16T15:19:31.249Z","etag":null,"topics":["anime","anime-downloader","download","m3u8-downloader","python","scraper","zoro","zoroanime"],"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/aditya76-git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-08-30T01:14:39.000Z","updated_at":"2023-12-20T16:14:01.864Z","dependencies_parsed_at":null,"dependency_job_id":"42ed69f0-47ce-4e7b-a09a-6e78e9aaf86a","html_url":"https://github.com/aditya76-git/zoro-dl","commit_stats":{"total_commits":23,"total_committers":2,"mean_commits":11.5,"dds":"0.21739130434782605","last_synced_commit":"2a115cb7a6cfc2ecc9b33275e322c9539def85db"},"previous_names":["aditya76-git/zoro-dl"],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fzoro-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fzoro-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fzoro-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fzoro-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aditya76-git","download_url":"https://codeload.github.com/aditya76-git/zoro-dl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248558319,"owners_count":21124256,"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":["anime","anime-downloader","download","m3u8-downloader","python","scraper","zoro","zoroanime"],"created_at":"2024-11-15T03:28:50.882Z","updated_at":"2025-04-12T11:22:29.168Z","avatar_url":"https://github.com/aditya76-git.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Logo](https://i.imgur.com/VR5m7DR.png)\r\n\r\n\u003cdiv style=\"text-align:center;\"\u003e\r\n  \u003ca href=\"https://github.com/aditya76-git\"\u003eaditya76-git\u003c/a\u003e /\r\n  \u003ca href=\"https://github.com/aditya76-git/zoro-dl\"\u003ezoro-dl\u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cbr /\u003e\r\n\r\n# 🔥ZORO-DL - A Python Package to Download Anime from ZORO [DUAL AUDIO] [MULTI SUBS]\r\n\r\nZORO-DL is a powerful Python package designed to simplify the process of downloading your favorite anime content from ZORO\r\n\r\nYou can Download Anime in DUAL AUDIO (JPN-ENG) with MULTI-SUBS\r\n\r\n# ✅Status\r\n\r\n![Status](https://consumet-api-status.vercel.app/?url=https://api.consumet.org/anime/zoro/watch?episodeId=death-note-60$episode$1464$dub)\r\n\r\nThe project heavily relies on the [CONSUMET API](https://consumet.org/). If the API experiences downtime, the project won't function. Kindly wait until the developers restore the API to its operational state.\r\n\r\n# 📋Details\r\n\r\n- [🔎Why ZORO-DL](#why-zoro-dl)\r\n- [⚠️ Disclaimer](#disclaimer)\r\n- [💡Pre Requisite](#pre-requisite)\r\n  - [🔨FFmpeg](#ffmpeg)\r\n- [⚙️Installation](#installation)\r\n- [🚀Initialization](#initialization)\r\n- [📚USAGE GUIDE](#usage-guide)\r\n  - [🌍DUAL-AUDIO MULTI-SUBS](#both)\r\n  - [🎧JPN AUDIO MULTI-SUBS](#sub)\r\n  - [🔊ENG AUDIO](#dub)\r\n- [📋TERMINAL OUTPUT](#terminal-output)\r\n- [📂MEDIAINFO](#mediainfo)\r\n- [🌟Show Your Support](#show-your-support)\r\n- [👨‍💻Developement](#developement)\r\n- [🤝Contributors](#contributors)\r\n- [🙌🏼Thanks To](#thanks-to)\r\n- [💻Authors](#authors)\r\n\r\n# \u003ca id=\"why-zoro-dl\"\u003e\u003c/a\u003e🔎Why ZORO-DL\r\n\r\nNavigating through the ads on ZORO.to can be a bit of a hassle, Pop-ups left and right, interrupting your anime viewing experience While ad blockers work online, what if you want to enjoy your shows offline? That's where ZORO-DL comes into play.\r\n\r\nMost sites offer those massive Video files that eat up your storage. But ZORO? They've got thier own encodes which are very tiny. They just have a small watermark for once or twice, hardly noticeable.You can get both the Audios Japanese and English with Multi Subs in around 300 MB for 1080p modern animes\r\n\r\nPerfect for ZORO fans who want their favorite episodes ready to watch anytime, anywhere. No more hassle, just straightforward anime enjoyment.\r\n\r\n# \u003ca id=\"disclaimer\"\u003e\u003c/a\u003e⚠️ Disclaimer\r\n\r\n`ZORO-DL` is a tool that uses the `API` provided by [consumet.org](https://consumet.org/) to fetch streaming links from `ZORO.to`. It does not claim any `ownership` or `affiliation` with ZORO.to or consumet.org. ZORO-DL is solely developed to enhance the user experience by providing a convenient way to download and enjoy anime content from `ZORO.to`. Use this tool responsibly and in accordance with the terms of use of the respective websites.\r\n\r\nThe essence of this `project` lies in the seamless integration of `automation` and `efficiency` to harness the content available on the internet. It's important to note that all the content accessed through this project is sourced from `external`, `non-affiliated` platforms.\r\n\r\n# \u003ca id=\"pre-requisite\"\u003e\u003c/a\u003e💡Pre Requisite\r\n\r\n## \u003ca id=\"ffmpeg\"\u003e\u003c/a\u003e🔨FFmpeg\r\n\r\nBefore using this tool, please ensure that you have `FFmpeg` installed and added to your system's PATH. `FFmpeg` is a crucial component for video processing and manipulation, which ZORO-DL relies on. Follow the steps below to install `FFmpeg` on different operating systems:\r\n\r\n## Linux (Ubuntu/Debian):\r\n\r\n```bash\r\nsudo apt install ffmpeg\r\n```\r\n\r\n## MacOS:\r\n\r\n- Open Terminal\r\n- Install Homebrew if you haven't already. Paste this command and press Enter:\r\n\r\n```bash\r\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\r\n```\r\n\r\n- Install FFmpeg by typing:\r\n\r\n```bash\r\nbrew install ffmpeg\r\n```\r\n\r\n## Windows:\r\n\r\nClick [here](https://www.gyan.dev/ffmpeg/builds/ffmpeg-git-full.7z) to download the zip file of the latest version.\r\n![STEP 1](https://media.geeksforgeeks.org/wp-content/uploads/20210912143634/Screenshotfrom20210912142407.png)\r\nUnzip this file by using any file archiver such as Winrar or 7z.\r\n![STEP 2](https://media.geeksforgeeks.org/wp-content/uploads/20210912212008/1.png)\r\nRename the extracted folder to ffmpeg and move it into the root of C: drive.\r\n![STEP 3](https://media.geeksforgeeks.org/wp-content/uploads/20210912212010/3.png)\r\nNow, run `cmd` as an administrator and set the environment path variable for `ffmpeg` by running the following `command`:\r\n\r\n```bash\r\nsetx /m PATH \"C:\\ffmpeg\\bin;%PATH%\"\r\n```\r\n\r\n![STEP 4](https://media.geeksforgeeks.org/wp-content/uploads/20210912212036/Screenshotfrom20210912211815.png)\r\n\r\n\u003e GUIDE SOURCE - [GEEKSFORGEEKS](https://www.geeksforgeeks.org/how-to-install-ffmpeg-on-windows/)\r\n\r\n# \u003ca id=\"installation\"\u003e\u003c/a\u003e⚙️Installation\r\n\r\nOpen your terminal or command prompt and enter the following command:\r\n\r\n```bash\r\npip install git+https://github.com/aditya76-git/zoro-dl@main\r\n```\r\n\r\n# \u003ca id=\"initialization\"\u003e\u003c/a\u003e🚀Initialization\r\n\r\nTo get started, you need to initialize an instance of the `ZORO` class\r\n\r\n```python3\r\nfrom zoro_dl import ZORO\r\n\r\n# Initialize ZORO class with required parameters\r\nzoro = ZORO(\r\n    url=\"ZORO_URL\",\r\n    season=\"1\",\r\n    episode=\"1-5\",\r\n    resolution=\"1080p\",\r\n    dl_type=\"both\",\r\n    group_tag=\"YourGroupTag\"\r\n)\r\n\r\n```\r\n\r\n| Parameter    | Type            | Description                                                                                                                                                                                                                                                                                                                                                                                                                               | Example                                                |\r\n| :----------- | :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------- |\r\n| `url `       | `str`           | **Required**. The URL of the anime series on ZORO.to that you want to download from.                                                                                                                                                                                                                                                                                                                                                      | https://aniwatch.to/watch/baki-hanma-son-of-ogre-15723 |\r\n| `season`     | `str`           | **Optional**. The season which will be added to the filename. Defaults to \"1\". Since ZORO have different URL for different seasons of a particular, This is important to be passed inorder to generate appropiate filenames                                                                                                                                                                                                               | 1                                                      |\r\n| `episode`    | `str` or `None` | **Optional**. Episodes to be downloaded. Can be a range of episodes (e.g., \"1-5\"), a single episode (e.g., \"10\"), or None to download the complete season. Defaults to None.                                                                                                                                                                                                                                                              | 1-5                                                    |\r\n| `resolution` | `str` or `None` | **Optional**. The resolution for downloading (e.g., \"1080p\" , \"720p\"). Defaults to \"1080p\".                                                                                                                                                                                                                                                                                                                                               | 720p                                                   |\r\n| `dl_type`    | `str` or `None` | **Optional**. Download type: \"sub\", \"dub\", or \"both\". Defaults to \"both\". \"sub\" will download in JPN Audio with All Available Subtitles, \"dub\" will download only in ENG Audio and \"both\" with download in JPN-ENG with All Available Subtitles. Make sure to verify the series which you want to DL in \"both\",If it has same duration in both sub and dub player on ZORO, Only then it will work or else you will have audio sync issues | both                                                   |\r\n| `group_tag`  | `str` or `None` | **Optional**. Custom group tag for metadata. Defaults to \"NOGRP\"                                                                                                                                                                                                                                                                                                                                                                          | S3BS                                                   |\r\n\r\n# \u003ca id=\"usage-guide\"\u003e\u003c/a\u003e📚USAGE GUIDE\r\n\r\n## \u003ca id=\"both\"\u003e\u003c/a\u003e🌍DUAL-AUDIO MULTI-SUBS\r\n\r\nMake sure to verify the `series` which you want to `DL` in \"both\",If it has same duration in both `sub` and `dub` player on `ZORO`, Only then it will work or else you will have audio sync issues\r\n\r\nWill download in JPN-ENG Audio with All Available Subtitles\r\n\r\n```\r\ndl_type = \"both\"\r\n```\r\n\r\n```python3\r\nfrom zoro_dl import ZORO\r\n\r\nzoro = ZORO(\r\n    url=\"ZORO_URL\",\r\n    season=\"1\",\r\n    episode=\"1-5\",\r\n    resolution=\"1080p\",\r\n    dl_type=\"both\",\r\n    group_tag=\"YourGroupTag\"\r\n)\r\nzoro.start_dl()\r\n\r\n```\r\n\r\n## \u003ca id=\"sub\"\u003e\u003c/a\u003e🎧JPN AUDIO MULTI-SUBS\r\n\r\nWill download in JPN Audio with All Available Subtitles\r\n\r\n```\r\ndl_type = \"sub\"\r\n```\r\n\r\n```python3\r\nfrom zoro_dl import ZORO\r\n\r\nzoro = ZORO(\r\n    url=\"ZORO_URL\",\r\n    season=\"1\",\r\n    episode=\"1-5\",\r\n    resolution=\"1080p\",\r\n    dl_type=\"sub\",\r\n    group_tag=\"YourGroupTag\"\r\n)\r\nzoro.start_dl()\r\n\r\n```\r\n\r\n## \u003ca id=\"dub\"\u003e\u003c/a\u003e🔊ENG AUDIO\r\n\r\nWill download in ENG Audio with No Subtitles\r\n\r\n```\r\ndl_type = \"dub\"\r\n```\r\n\r\n```python3\r\nfrom zoro_dl import ZORO\r\n\r\nzoro = ZORO(\r\n    url=\"ZORO_URL\",\r\n    season=\"1\",\r\n    episode=\"1-5\",\r\n    resolution=\"1080p\",\r\n    dl_type=\"dub\",\r\n    group_tag=\"YourGroupTag\"\r\n)\r\nzoro.start_dl()\r\n\r\n```\r\n\r\n# \u003ca id=\"terminal-output\"\u003e\u003c/a\u003e📋 TERMINAL OUTPUT\r\n\r\n```\r\n----------------------------------------------------------------------\r\nEXTRACTING STREAMS\r\n[+] DOWNLOADING - Baki Hanma: Son of Ogre S01E01 The World's Strongest Senior - 1080p\r\n[+] DOWNLOADING JPN VIDEO SOURCE\r\n[+] DOWNLOADING ENG VIDEO SOURCE\r\n[+] DOWNLOADING SUBTITLES (TOTAL - 34 FOUND)\r\n[+] MUXING FILES\r\n[+] TASK COMPLETED IN 41s\r\n[+] FILE [Conan76] Baki Hanma: Son of Ogre S01E01 The World's Strongest Senior [1080p] [WEB] [JPN-ENG] [MULTI-SUBS].mkv\r\n[+] Cleaning Temp Video Files\r\n[+] Cleaning Temp Subtitle Files\r\n```\r\n\r\n# \u003ca id=\"mediainfo\"\u003e\u003c/a\u003e📂 MEDIAINFO\r\n\r\n```\r\nUnique ID                                : 27636542821203888231540861625285126985 (0x14CA9AC2FE6B696FCA68967ED0FEAB49)\r\nComplete name                            : /content/[Conan76] Baki: Dai Raitaisai-hen S01E03 Revived! [1080p] [WEB] [JPN-ENG] [MULTI-SUBS].mkv\r\nFormat                                   : Matroska\r\nFormat version                           : Version 4\r\nFile size                                : 286 MiB\r\nDuration                                 : 23 min 57 s\r\nOverall bit rate                         : 1 670 kb/s\r\nEncoded by                               : Conan76\r\nWriting application                      : Lavf58.76.100\r\nWriting library                          : Lavf58.76.100\r\nErrorDetectionType                       : Per level 1\r\nDATE                                     : 2023-08-29T19:40:38.1290870+00:00\r\n\r\nVideo\r\nID                                       : 1\r\nFormat                                   : AVC\r\nFormat/Info                              : Advanced Video Codec\r\nFormat profile                           : High@L5\r\nFormat settings                          : CABAC / 5 Ref Frames\r\nFormat settings, CABAC                   : Yes\r\nFormat settings, Reference frames        : 5 frames\r\nCodec ID                                 : V_MPEG4/ISO/AVC\r\nDuration                                 : 23 min 57 s\r\nWidth                                    : 1 920 pixels\r\nHeight                                   : 1 080 pixels\r\nDisplay aspect ratio                     : 16:9\r\nFrame rate mode                          : Constant\r\nFrame rate                               : 25.000 FPS\r\nColor space                              : YUV\r\nChroma subsampling                       : 4:2:0\r\nBit depth                                : 8 bits\r\nScan type                                : Progressive\r\nTitle                                    : Conan76 - Sourced from ZORO\r\nWriting library                          : x264 core 148 r2795 aaa9aa8\r\nEncoding settings                        : cabac=1 / ref=5 / deblock=1:0:0 / analyse=0x3:0x113 / me=hex / subme=8 / psy=1 / psy_rd=1.00:0.00 / mixed_ref=1 / me_range=16 / chroma_me=1 / trellis=2 / 8x8dct=1 / cqm=0 / deadzone=21,11 / fast_pskip=1 / chroma_qp_offset=-2 / threads=24 / lookahead_threads=4 / sliced_threads=0 / nr=0 / decimate=1 / interlaced=0 / bluray_compat=0 / constrained_intra=0 / bframes=3 / b_pyramid=2 / b_adapt=1 / b_bias=0 / direct=3 / weightb=1 / open_gop=0 / weightp=2 / keyint=250 / keyint_min=25 / scenecut=40 / intra_refresh=0 / rc_lookahead=50 / rc=crf / mbtree=1 / crf=25.0 / qcomp=0.60 / qpmin=0 / qpmax=69 / qpstep=4 / ip_ratio=1.40 / aq=1:1.00\r\nDefault                                  : Yes\r\nForced                                   : No\r\nVENDOR_ID                                : [0][0][0][0]\r\n\r\nAudio #1\r\nID                                       : 2\r\nFormat                                   : AAC LC\r\nFormat/Info                              : Advanced Audio Codec Low Complexity\r\nCodec ID                                 : A_AAC-2\r\nDuration                                 : 23 min 57 s\r\nChannel(s)                               : 2 channels\r\nChannel layout                           : L R\r\nSampling rate                            : 48.0 kHz\r\nFrame rate                               : 46.875 FPS (1024 SPF)\r\nCompression mode                         : Lossy\r\nDelay relative to video                  : -80 ms\r\nTitle                                    : Conan76\r\nLanguage                                 : Japanese\r\nDefault                                  : Yes\r\nForced                                   : No\r\nVENDOR_ID                                : [0][0][0][0]\r\n\r\nAudio #2\r\nID                                       : 3\r\nFormat                                   : AAC LC\r\nFormat/Info                              : Advanced Audio Codec Low Complexity\r\nCodec ID                                 : A_AAC-2\r\nDuration                                 : 23 min 57 s\r\nChannel(s)                               : 2 channels\r\nChannel layout                           : L R\r\nSampling rate                            : 48.0 kHz\r\nFrame rate                               : 46.875 FPS (1024 SPF)\r\nCompression mode                         : Lossy\r\nDelay relative to video                  : -80 ms\r\nTitle                                    : Conan76\r\nLanguage                                 : English\r\nDefault                                  : No\r\nForced                                   : No\r\nVENDOR_ID                                : [0][0][0][0]\r\n\r\nText #1\r\nID                                       : 4\r\nFormat                                   : D_WEBVTT/SUBTITLES\r\nCodec ID                                 : D_WEBVTT/SUBTITLES\r\nDuration                                 : 23 min 43 s\r\nTitle                                    : Arabic\r\nLanguage                                 : Arabic\r\nDefault                                  : Yes\r\nForced                                   : No\r\n\r\nText #2\r\nID                                       : 5\r\nFormat                                   : D_WEBVTT/SUBTITLES\r\nCodec ID                                 : D_WEBVTT/SUBTITLES\r\nDuration                                 : 23 min 43 s\r\nTitle                                    : Chinese\r\nLanguage                                 : Chinese\r\nDefault                                  : No\r\nForced                                   : No\r\n\r\n..... (OTHER 27 SUBTITLE TRACKS)\r\n\r\n```\r\n\r\n# \u003ca id=\"show-your-support\"\u003e\u003c/a\u003e🌟Show Your Support\r\n\r\n- If you find this project useful or interesting, please consider giving it a star on GitHub. It's a simple way to show your support and help others discover the project.\r\n\r\n![Github Stars](https://img.shields.io/github/stars/aditya76-git/zoro-dl?style=social \"Github Stars\")\r\n\r\n# \u003ca id=\"developement\"\u003e\u003c/a\u003e👨‍💻Developement\r\n\r\nThank you for your interest in contributing to this project! There are several ways you can get involved:\r\n\r\n- **Opening Issues**: If you encounter a bug, have a feature request, or want to suggest an improvement, please open an issue. We appreciate your feedback!\r\n- **Cloning the Project**: To work on the project locally, you can clone the repository by running:\r\n\r\n```bash\r\ngit clone https://github.com/aditya76-git/zoro-dl.git\r\n```\r\n\r\n- **Sending Pull Requests**: If you'd like to contribute directly to the codebase, you can fork the repository, make your changes, and then send a pull request. We welcome your contributions!\r\n\r\n# \u003ca id=\"contributors\"\u003e\u003c/a\u003e🤝Contributors\r\n\r\nA Big **Thanks** to those who helped make our project better.\r\n\r\n**Karan Adhikari**\r\n\r\n- GitHub: [@weebzone](https://github.com/weebzone)\r\n\r\n# \u003ca id=\"thanks-to\"\u003e\u003c/a\u003e🙌🏼Thanks To\r\n\r\n- ZORO\r\n- CONSUMET API - [https://github.com/consumet/api.consumet.org](https://github.com/consumet/api.consumet.org)\r\n\r\n# \u003ca id=\"authors\"\u003e\u003c/a\u003e💻Authors\r\n\r\n- Copyright © 2023 - [aditya76-git](https://github.com/aditya76-git) / [zoro-dl](https://github.com/aditya76-git/zoro-dl)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faditya76-git%2Fzoro-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faditya76-git%2Fzoro-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faditya76-git%2Fzoro-dl/lists"}