ZORO-DL is a powerful Python package designed to simplify the process of downloading your favorite anime content from ZORO
You can Download Anime in DUAL AUDIO (JPN-ENG) with MULTI-SUBS
The project heavily relies on the CONSUMET API. If the API experiences downtime, the project won't function. Kindly wait until the developers restore the API to its operational state.
- 🔎Why ZORO-DL
⚠️ Disclaimer- 💡Pre Requisite
- ⚙️Installation
- 🚀Initialization
- 📚USAGE GUIDE
- 📋TERMINAL OUTPUT
- 📂MEDIAINFO
- 🌟Show Your Support
- 👨💻Developement
- 🤝Contributors
- 🙌🏼Thanks To
- 💻Authors
Navigating 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.
Most 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
Perfect for ZORO fans who want their favorite episodes ready to watch anytime, anywhere. No more hassle, just straightforward anime enjoyment.
ZORO-DL is a tool that uses the API provided by 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.
The 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.
Before 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:
sudo apt install ffmpeg- Open Terminal
- Install Homebrew if you haven't already. Paste this command and press Enter:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"- Install FFmpeg by typing:
brew install ffmpegClick here to download the zip file of the latest version.
cmd as an administrator and set the environment path variable for ffmpeg by running the following command:
setx /m PATH "C:\ffmpeg\bin;%PATH%"
GUIDE SOURCE - GEEKSFORGEEKS
Open your terminal or command prompt and enter the following command:
pip install git+https://github.com/aditya76-git/zoro-dl@mainTo get started, you need to initialize an instance of the ZORO class
from zoro_dl import ZORO
# Initialize ZORO class with required parameters
zoro = ZORO(
url="ZORO_URL",
season="1",
episode="1-5",
resolution="1080p",
dl_type="both",
group_tag="YourGroupTag"
)| Parameter | Type | Description | Example |
|---|---|---|---|
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 |
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 |
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 |
resolution |
str or None |
Optional. The resolution for downloading (e.g., "1080p" , "720p"). Defaults to "1080p". | 720p |
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 |
group_tag |
str or None |
Optional. Custom group tag for metadata. Defaults to "NOGRP" | S3BS |
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
Will download in JPN-ENG Audio with All Available Subtitles
dl_type = "both"
from zoro_dl import ZORO
zoro = ZORO(
url="ZORO_URL",
season="1",
episode="1-5",
resolution="1080p",
dl_type="both",
group_tag="YourGroupTag"
)
zoro.start_dl()Will download in JPN Audio with All Available Subtitles
dl_type = "sub"
from zoro_dl import ZORO
zoro = ZORO(
url="ZORO_URL",
season="1",
episode="1-5",
resolution="1080p",
dl_type="sub",
group_tag="YourGroupTag"
)
zoro.start_dl()Will download in ENG Audio with No Subtitles
dl_type = "dub"
from zoro_dl import ZORO
zoro = ZORO(
url="ZORO_URL",
season="1",
episode="1-5",
resolution="1080p",
dl_type="dub",
group_tag="YourGroupTag"
)
zoro.start_dl()----------------------------------------------------------------------
EXTRACTING STREAMS
[+] DOWNLOADING - Baki Hanma: Son of Ogre S01E01 The World's Strongest Senior - 1080p
[+] DOWNLOADING JPN VIDEO SOURCE
[+] DOWNLOADING ENG VIDEO SOURCE
[+] DOWNLOADING SUBTITLES (TOTAL - 34 FOUND)
[+] MUXING FILES
[+] TASK COMPLETED IN 41s
[+] FILE [Conan76] Baki Hanma: Son of Ogre S01E01 The World's Strongest Senior [1080p] [WEB] [JPN-ENG] [MULTI-SUBS].mkv
[+] Cleaning Temp Video Files
[+] Cleaning Temp Subtitle Files
Unique ID : 27636542821203888231540861625285126985 (0x14CA9AC2FE6B696FCA68967ED0FEAB49)
Complete name : /content/[Conan76] Baki: Dai Raitaisai-hen S01E03 Revived! [1080p] [WEB] [JPN-ENG] [MULTI-SUBS].mkv
Format : Matroska
Format version : Version 4
File size : 286 MiB
Duration : 23 min 57 s
Overall bit rate : 1 670 kb/s
Encoded by : Conan76
Writing application : Lavf58.76.100
Writing library : Lavf58.76.100
ErrorDetectionType : Per level 1
DATE : 2023-08-29T19:40:38.1290870+00:00
Video
ID : 1
Format : AVC
Format/Info : Advanced Video Codec
Format profile : High@L5
Format settings : CABAC / 5 Ref Frames
Format settings, CABAC : Yes
Format settings, Reference frames : 5 frames
Codec ID : V_MPEG4/ISO/AVC
Duration : 23 min 57 s
Width : 1 920 pixels
Height : 1 080 pixels
Display aspect ratio : 16:9
Frame rate mode : Constant
Frame rate : 25.000 FPS
Color space : YUV
Chroma subsampling : 4:2:0
Bit depth : 8 bits
Scan type : Progressive
Title : Conan76 - Sourced from ZORO
Writing library : x264 core 148 r2795 aaa9aa8
Encoding 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
Default : Yes
Forced : No
VENDOR_ID : [0][0][0][0]
Audio #1
ID : 2
Format : AAC LC
Format/Info : Advanced Audio Codec Low Complexity
Codec ID : A_AAC-2
Duration : 23 min 57 s
Channel(s) : 2 channels
Channel layout : L R
Sampling rate : 48.0 kHz
Frame rate : 46.875 FPS (1024 SPF)
Compression mode : Lossy
Delay relative to video : -80 ms
Title : Conan76
Language : Japanese
Default : Yes
Forced : No
VENDOR_ID : [0][0][0][0]
Audio #2
ID : 3
Format : AAC LC
Format/Info : Advanced Audio Codec Low Complexity
Codec ID : A_AAC-2
Duration : 23 min 57 s
Channel(s) : 2 channels
Channel layout : L R
Sampling rate : 48.0 kHz
Frame rate : 46.875 FPS (1024 SPF)
Compression mode : Lossy
Delay relative to video : -80 ms
Title : Conan76
Language : English
Default : No
Forced : No
VENDOR_ID : [0][0][0][0]
Text #1
ID : 4
Format : D_WEBVTT/SUBTITLES
Codec ID : D_WEBVTT/SUBTITLES
Duration : 23 min 43 s
Title : Arabic
Language : Arabic
Default : Yes
Forced : No
Text #2
ID : 5
Format : D_WEBVTT/SUBTITLES
Codec ID : D_WEBVTT/SUBTITLES
Duration : 23 min 43 s
Title : Chinese
Language : Chinese
Default : No
Forced : No
..... (OTHER 27 SUBTITLE TRACKS)
- 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.
Thank you for your interest in contributing to this project! There are several ways you can get involved:
- 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!
- Cloning the Project: To work on the project locally, you can clone the repository by running:
git clone https://github.com/aditya76-git/zoro-dl.git- 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!
A Big Thanks to those who helped make our project better.
Karan Adhikari
- GitHub: @weebzone
- ZORO
- CONSUMET API - https://github.com/consumet/api.consumet.org
- Copyright © 2023 - aditya76-git / zoro-dl