AniWorld Downloader is a command-line tool built to download and stream anime content from aniworld.to. With it, you can grab single episodes, download entire seasons, and organize files into neatly structured folders. It's cross-platform, so it works on Windows, macOS, and Linux for a smooth experience across all major OSes.
windows-curses, which is needed for the menu to work on Windows. To avoid issues, please use Python 3.12 until windows-curses is updated. Check for updates here.
To install the latest release of AniWorld Downloader, run:
pip install aniworld
To update to the latest version, use:
pip install -U aniworld
To install the latest development changes directly from GitHub, use:
pip install --upgrade git+https://github.com/phoenixthrush/AniWorld-Downloader.git#egg=aniworld
To update, simply rerun the command above. These builds may be unstable, so it’s good to check regularly.
If you prefer to have the files locally:
Clone the repository:
git clone https://github.com/phoenixthrush/AniWorld-Downloader aniworld
Install it in editable mode:
pip install -U -e ./aniworld
To keep your local version up to date, run:
git -C aniworld pull
To uninstall AniWorld Downloader, run the following command:
aniworld --uninstall
To launch AniWorld Downloader with an interactive menu, use:
aniworld
AniWorld Downloader supports various command-line options for downloading and streaming anime without using the interactive menu. This allows access to advanced features not available in the menu (e.g., --aniskip, --keep-watching, --syncplay-password).
To download episode 1 of "Demon Slayer: Kimetsu no Yaiba":
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1
To download multiple episodes of "Demon Slayer":
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-2
To watch an episode while skipping intros and outros:
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Watch --aniskip
To syncplay a specific episode with friends:
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching
You can choose different languages for yourself and your friends:
For German Dub:
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching --language "German Dub" --aniskip
For English Sub:
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching --language "English Sub" --aniskip
Note: Anyone watching the same anime (regardless of episode) will automatically join the room if Syncplay is enabled. To restrict access to strangers, set a password for the room:
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching --language "English Sub" --aniskip --syncplay-password beans
To download an episode using the VOE provider with English subtitles:
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --provider VOE --language "English Sub"
You can download episodes listed in a text file. Here’s an example of what the text file (test.txt) should look like:
# The whole anime
https://aniworld.to/anime/stream/alya-sometimes-hides-her-feelings-in-russian
# The whole Season 2
https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-2
# Only Season 3 Episode 13
https://aniworld.to/anime/stream/kaguya-sama-love-is-war/staffel-3/episode-13
To download the episodes specified in the file, use:
aniworld --episode-file /Users/goofball/Downloads/test.txt --language "German Dub"
You can also combine this with Watch and Syncplay actions, along with other arguments as needed.
To set up Anime4K, run the following commands based on your GPU type. This setup will install everything needed to use Anime4K in the mpv player, even outside of AniWorld.
(e.g., GTX 1080, RTX 2070, RTX 3060, RX 590, Vega 56, 5700XT, 6600XT, M1 Pro, M1 Max, M1 Ultra, M2 Pro, M2 Max)
aniworld --anime4k High
(e.g., GTX 980, GTX 1060, RX 570, M1, M2, Intel chips)
aniworld --anime4k Low
If you want to uninstall Anime4K, use the following command:
aniworld --anime4k Remove
High or Low).Remove option to uninstall Anime4K easily.aniworld --help
usage: aniworld [-h] [-v] [-d] [-u] [-U {mpv,yt-dlp,syncplay,all}] [-s SLUG]
[-l LINK] [-q QUERY] [-e EPISODE [EPISODE ...]]
[-f EPISODE_FILE] [-lf] [-a {Watch,Download,Syncplay}]
[-o OUTPUT] [-O OUTPUT_DIRECTORY]
[-L {German Dub,English Sub,German Sub}]
[-p {Vidoza,Streamtape,VOE,Doodstream}] [-A {High,Low,Remove}]
[-sH SYNCPLAY_HOSTNAME] [-sU SYNCPLAY_USERNAME]
[-sR SYNCPLAY_ROOM]
[-sP SYNCPLAY_PASSWORD [SYNCPLAY_PASSWORD ...]] [-k] [-K]
[-r [RANDOM_ANIME]] [-D] [-C] [-x PROXY] [-w]
Parse optional command line arguments.
options:
-h, --help show this help message and exit
General Options:
-v, --version Print version info
-d, --debug Enable debug mode
-u, --uninstall Self uninstall
-U {mpv,yt-dlp,syncplay,all}, --update {mpv,yt-dlp,syncplay,all}
Update mpv, yt-dlp, syncplay, or all.
Search Options:
-s SLUG, --slug SLUG Search query - E.g. demon-slayer-kimetsu-no-yaiba
-l LINK, --link LINK Search query - E.g.
https://aniworld.to/anime/stream/demon-slayer-kimetsu-
no-yaiba
-q QUERY, --query QUERY
Search query input - E.g. demon
Episode Options:
-e EPISODE [EPISODE ...], --episode EPISODE [EPISODE ...]
List of episode URLs
-f EPISODE_FILE, --episode-file EPISODE_FILE
File path containing a list of episode URLs
-lf, --episode-local NOT IMPLEMENTED YET - Use local episode files instead
of URLs
Action Options:
-a {Watch,Download,Syncplay}, --action {Watch,Download,Syncplay}
Action to perform
-o OUTPUT, --output OUTPUT
Download directory E.g. /Users/phoenixthrush/Downloads
-O OUTPUT_DIRECTORY, --output-directory OUTPUT_DIRECTORY
Final download directory E.g ExampleDirectory,
defaults to anime name if not specified
-L {German Dub,English Sub,German Sub}, --language {German Dub,English Sub,German Sub}
Language choice
-p {Vidoza,Streamtape,VOE,Doodstream}, --provider {Vidoza,Streamtape,VOE,Doodstream}
Provider choice
Anime4K Options:
-A {High,Low,Remove}, --anime4k {High,Low,Remove}
Set Anime4K optimised mode (High Eg.: GTX 1080, RTX
2070, RTX 3060, RX 590, Vega 56, 5700XT, 6600XT; Low
Eg.: GTX 980, GTX 1060, RX 570, or Remove).
Syncplay Options:
-sH SYNCPLAY_HOSTNAME, --syncplay-hostname SYNCPLAY_HOSTNAME
Set syncplay hostname
-sU SYNCPLAY_USERNAME, --syncplay-username SYNCPLAY_USERNAME
Set syncplay username
-sR SYNCPLAY_ROOM, --syncplay-room SYNCPLAY_ROOM
Set syncplay room
-sP SYNCPLAY_PASSWORD [SYNCPLAY_PASSWORD ...], --syncplay-password SYNCPLAY_PASSWORD [SYNCPLAY_PASSWORD ...]
Set a syncplay room password
Miscellaneous Options:
-k, --aniskip Skip intro and outro
-K, --keep-watching Continue watching
-r [RANDOM_ANIME], --random-anime [RANDOM_ANIME]
Select random anime (default genre is "all", Eg.:
Drama)
-D, --only-direct-link
Output direct link
-C, --only-command Output command
-x PROXY, --proxy PROXY
Set HTTP Proxy - E.g. http://0.0.0.0:8080
-w, --use-playwright Bypass fetching with a headless browser using
Playwright instead (EXPERIMENTAL!!!)
AniWorld Downloader requires the following Python packages:
requestsbeautifulsoup4npyscreencolorlogpy7zrpackagingyt-dlpwindows-curses (only for Windows users)These packages are automatically installed when you set up AniWorld Downloader using pip.
Command-Line Improvements
argparse for command-line argument parsing.Logging and Proxy Support
Automatic Installations
mpvyt-dlpSyncplayFeature Enhancements
Bug Fixes
Aniworld-Downloader currently supports three providers:
Doodstream is not supported due to constant backend updates that block download attempts. While I initially had support for it, Doodstream's backend changes rendered my previous method obsolete.
In older versions, the default provider for both downloading and watching with syncplay and mpv was Vidoza. However, since Vidoza and Streamtape throttle download speeds, I recommend using VOE for downloads, as it can fully utilize your bandwidth.
Drawback of VOE:
Current Recommendations:
Download in this order:
VOE > Vidoza > Streamtape
For viewing in mpv or syncplay:
Vidoza > Streamtape > VOE
I previously had support for s.to in a separate branch, but it is now unmaintained and untested. Currently, I do not plan to re-implement support for s.to, as I've focused on stabilizing the existing code. Before adding new providers, I need to streamline the backend, which is somewhat messy due to redundant functions and fetches from recent feature additions.
Note on Adding s.to Support:
There are already other tools that support s.to. For terminal-based viewing of s.to, check out my friend's project called gucken—he’s doing great work there.
Regarding Aniworld’s claim of hosting 1,000+ license-free anime, it’s worth noting that they also stream new shows that may require subscriptions elsewhere. Supporting s.to could mean indirectly accessing copyrighted content, such as Netflix originals. As I do not host any content but fetch it directly from streaming providers, I am not liable for any issues arising from downloading anime.
Feel free to contribute! Any help is appreciated, and I’d be happy to merge in support for s.to or bs.to if it gets added.
Contributions to AniWorld Downloader are welcome! Your input helps improve the project, whether it’s through:
Lulu (since Sep 14, 2024)
Tmaster055 (since Oct 21, 2024)
Thank you Tmaster055 for fixing Aniskip by fetching the correct MAL ID!
This project is licensed under the MIT License.
For more details, see the LICENSE file.
I’ve received several reports from users experiencing unexpected menu quits. Recently, streaming providers have started blocking IP addresses from downloading. You can bypass this by using a VPN. You might try using the --use-playwright option instead, though it's still experimental and may not be very effective. Additionally, run aniworld with the --debug flag.
This will typically reveal a timeout error, indicating the domain couldn’t be reached or another issue.
If you still need assistance with AniWorld Downloader, you can:
@phoenixthrush:matrix.org, or on Discord phoenixthrush.While I do respond to emails, opening a GitHub issue is preferable, even for installation questions, so others can find solutions too. However, I’m still happy to help via email if you prefer.
If you enjoy AniWorld Downloader and want to support the project, please consider starring the repository on GitHub. It’s a small gesture that means a lot and motivates me to keep improving the project.
Thank you for your support and feedback!
FAQs
Cross-platform command-line tool to download and stream anime from aniworld.to
We found that aniworld demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.