Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aditya76-git/zoro-dl
ZORO-DL -🔥A Python Package to Download Anime from ZORO [DUAL AUDIO] [MULTI SUBS]
https://github.com/aditya76-git/zoro-dl
anime anime-downloader download m3u8-downloader python scraper zoro zoroanime
Last synced: 2 months ago
JSON representation
ZORO-DL -🔥A Python Package to Download Anime from ZORO [DUAL AUDIO] [MULTI SUBS]
- Host: GitHub
- URL: https://github.com/aditya76-git/zoro-dl
- Owner: aditya76-git
- License: mit
- Created: 2023-08-30T01:14:39.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-13T06:34:20.000Z (about 1 year ago)
- Last Synced: 2023-12-16T15:19:31.249Z (about 1 year ago)
- Topics: anime, anime-downloader, download, m3u8-downloader, python, scraper, zoro, zoroanime
- Language: Python
- Homepage:
- Size: 12.5 MB
- Stars: 5
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🔥ZORO-DL - A Python Package to Download Anime from ZORO [DUAL AUDIO] [MULTI SUBS]
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
# ✅Status
The 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.
# 📋Details
- [🔎Why ZORO-DL](#why-zoro-dl)
- [⚠️ Disclaimer](#disclaimer)
- [💡Pre Requisite](#pre-requisite)
- [🔨FFmpeg](#ffmpeg)
- [⚙️Installation](#installation)
- [🚀Initialization](#initialization)
- [📚USAGE GUIDE](#usage-guide)
- [🌍DUAL-AUDIO MULTI-SUBS](#both)
- [🎧JPN AUDIO MULTI-SUBS](#sub)
- [🔊ENG AUDIO](#dub)
- [📋TERMINAL OUTPUT](#terminal-output)
- [📂MEDIAINFO](#mediainfo)
- [🌟Show Your Support](#show-your-support)
- [👨💻Developement](#developement)
- [🤝Contributors](#contributors)
- [🙌🏼Thanks To](#thanks-to)
- [💻Authors](#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](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.
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:
## Linux (Ubuntu/Debian):
```bash
sudo apt install ffmpeg
```
## MacOS:
- Open Terminal
- Install Homebrew if you haven't already. Paste this command and press Enter:
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
- Install FFmpeg by typing:
```bash
brew install ffmpeg
```
## Windows:
Click [here](https://www.gyan.dev/ffmpeg/builds/ffmpeg-git-full.7z) to download the zip file of the latest version.
Unzip this file by using any file archiver such as Winrar or 7z.
Rename the extracted folder to ffmpeg and move it into the root of C: drive.
Now, run `cmd` as an administrator and set the environment path variable for `ffmpeg` by running the following `command`:
```bash
setx /m PATH "C:\ffmpeg\bin;%PATH%"
```
> GUIDE SOURCE - [GEEKSFORGEEKS](https://www.geeksforgeeks.org/how-to-install-ffmpeg-on-windows/)
Open your terminal or command prompt and enter the following command:
```bash
pip install git+https://github.com/aditya76-git/zoro-dl@main
```
To get started, you need to initialize an instance of the `ZORO` class
```python3
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"
```
```python3
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"
```
```python3
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"
```
```python3
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:
```bash
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](https://github.com/weebzone)
- ZORO
- CONSUMET API - [https://github.com/consumet/api.consumet.org](https://github.com/consumet/api.consumet.org)
- Copyright © 2023 - [aditya76-git](https://github.com/aditya76-git) / [zoro-dl](https://github.com/aditya76-git/zoro-dl)