AniWorld Downloader v4

AniWorld Downloader is a cross-platform tool for streaming and downloading content from AniWorld, Hanime, MangaFire, MegaKino, and SerienStream, with more support coming in the future. It runs on Windows, macOS, and Linux, providing a seamless experience for offline viewing or instant playback.

Demo Menu

https://github.com/user-attachments/assets/d65c4a5c-827a-45d7-a904-78977fd9aef4

(back to top)

TL;DR - Quick Start

# Install stable release (needs Python installed)
pip install -U aniworld

# Or install latest GitHub commit (needs Git installed)
pip install --upgrade git+https://github.com/phoenixthrush/AniWorld-Downloader.git@models#egg=aniworld

# Launch AniWorld Downloader using Web UI
aniworld -w

# Using Menu
aniworld

Tip: Use the stable release for general use. The GitHub version includes the latest features and fixes but may be less stable.

(back to top)

Documentation

For full user guides, tutorials, and troubleshooting, visit the official documentation.

(back to top)

Features

• Downloading – Grab full series, individual seasons, or single episodes for offline viewing
• Streaming – Watch episodes instantly using mpv, IINA, or Syncplay
• Auto-Next Playback – Seamlessly move to the next episode without interruption
• Multiple Providers – Stream from various sources on aniworld.to and s.to
• Language Preferences – Switch between German Dub, English Sub, or German Sub
• Muxing – Automatically combine video and audio streams into a single file
• AniSkip Integration – Skip intros and outros on AniWorld for a smoother experience
• Group Watching – Sync anime and series sessions with friends via Syncplay
• Web Interface – Browse, download, and manage your queue with a modern web UI
• More Sites – Also search and download from Kinox, BurningSeries, FilmPalast, and Cineby

  Kinox is currently not recommended: it demands a captcha for every download (the same one all visitors get) that can't be solved automatically. Downloads still run without errors — when kinox blocks one, the queue shows a "Solve on Kinox" button that opens the title page so you can solve the captcha and hit Retry. Prefer the other sites for now.

  Cineby German audio is unreliable: Cineby lists a German audio track for almost everything, so the downloader offers German Dub accordingly — but in practice those German tracks often just don't work. That's a problem with Cineby's own sources, not with the downloader, so expect to fall back to English fairly often.

• Planned Releases – Queue titles that aren't out yet; they download automatically once available
• Discord Request Bot – Let others request movies/series from Discord, with owner approval
• Interface Language – Switch the whole UI between English and German
• Docker Ready – Deploy easily using Docker or Docker Compose

(back to top)

Still in Development

This project is actively being improved. Current work in progress includes:

• def unzip() for Windows in .zip and .7z files
• fix episode download cleanup on KeyboardInterrupt in menu
• add support for aniskip feature on IINA
• Implement keep-watching argument for continuous playback
• Fix Nuitka build crash: use Python 3.12 (non-MSVC builds unsupported on newer versions)
• Remove empty lines below actions when running docker run -it

(back to top)

Supported Providers

Currently Prioritized Providers

• AniWorld – VOE, Vidmoly, Vidoza, Doodstream
• SerienStream – VOE, Vidoza, Doodstream

(back to top)

Docker

Build the AniWorld Downloader Docker image:

docker build -t aniworld .

Running the Container

• macOS / Linux (bash/zsh):

docker run -it --rm \
  -v "${PWD}/Downloads:/app/Downloads" \
  aniworld python -m aniworld

• Windows (PowerShell):

docker run -it --rm `
  -v "${PWD}\Downloads:/app/Downloads" `
  aniworld python -m aniworld

• Windows (CMD):

docker run -it --rm ^
  -v "%cd%\Downloads:/app/Downloads" ^
  aniworld python -m aniworld

Note: Mount your local Downloads folder to /app/Downloads in the container to save downloaded episodes. You can adjust the host path as needed.

Docker Compose (with Web UI)

Start AniWorld Downloader using Docker Compose:

docker-compose up -d --build

This command will:

• Build the Docker image if it hasn’t been built yet
• Start the container in detached mode (-d)
• Enable the Web UI for easier interaction
• Automatically restart the container unless stopped manually (restart: unless-stopped)

To stop the container:

docker-compose down

Tip: Ensure your docker-compose.yml correctly configures volumes and ports if you want to persist downloads or access the Web UI externally.

(back to top)

Contributing

Contributions to AniWorld Downloader are highly appreciated! You can help improve the project in several ways:

• Report Bugs – Identify and report issues to improve functionality
• Suggest Features – Share ideas to expand the tool's capabilities
• Submit Pull Requests – Contribute code to fix bugs or add new features
• Improve Documentation – Help enhance user guides, tutorials, and technical documentation

Before submitting contributions, please check the repository for existing issues or feature requests to avoid duplicates.

Contributors

• Lulu (since Sep 14, 2024)
  

• Tmaster055 (since Oct 21, 2024)
  

(back to top)

Dependencies

AniWorld Downloader uses a small set of Python packages for networking, terminal UI, media handling, web features, and configuration.

Core dependencies

• niquests – HTTP requests (replaces requests)
• npyscreen – Text-based terminal UI
• ffmpeg-python – Python bindings for FFmpeg (requires FFmpeg installed on your system)
• python-dotenv – Loads environment variables from a .env file
• packaging – Version parsing and comparison
• cryptography – Cryptographic utilities
• patchright – Browser automation support for captcha handling

Web / server dependencies

• flask – Web framework
• flask-wtf – Forms and CSRF protection for Flask
• waitress – Production WSGI server

Optional dependencies (Extras)

Some features require optional packages which can be installed on demand:

• SSO Login (OIDC): Requires authlib (pip install aniworld[sso])
• Discord Bot: Requires discord.py (pip install aniworld[discord])

To install AniWorld Downloader with all optional features:

# For PyPI release
pip install aniworld[all]

# For local development
pip install -e .[all]

Platform-specific dependencies

• windows-curses – Enables curses support for npyscreen on Windows (installed only on Windows and only for Python versions below 3.14)

All core and web dependencies are installed automatically when AniWorld Downloader is installed with pip.

(back to top)

Credits

AniWorld Downloader builds upon the work of several outstanding open-source projects:

• mpv – A versatile media player used for seamless video streaming
• IINA – Modern macOS media player built on mpv, offering a sleek interface and advanced playback features
• Syncplay – Enables synchronized playback sessions with friends
• Anime4K – Real-time upscaler for enhancing anime video quality
• Aniskip – Provides opening and ending skip times for the Aniskip extension
• flag-icons – Collection of SVG country flags
• new-domain-check – Constant checks for new redirects on megakino
• fake-useragent - Simple useragent faker with real world database

(back to top)

Other Cool Projects

• Jellyfin AniWorld Downloader by SiroxCW – A Jellyfin plugin that lets you browse and download anime & series directly from AniWorld, fully integrated into your media server.

• AniBridge by Zzackllack – A minimal FastAPI service that bridges anime and series streaming catalogues (AniWorld, SerienStream/s.to, MegaKino) with automation tools.

(back to top)

Support

If you need help with AniWorld Downloader, you have several options:

• Submit an issue on the GitHub Issues page – preferred for installation problems, bug reports, or feature requests, as it helps others benefit from shared solutions
• Contact directly via email at contact@phoenixthrush.com or on our Discord server. Join here

While email support is available, opening a GitHub issue is encouraged whenever possible.

If you find AniWorld Downloader useful, please star the repository on GitHub. Your support is greatly appreciated and motivates continued development.

Thank you for using AniWorld Downloader!

(back to top)

Legal Disclaimer

AniWorld Downloader is a client-side tool that enables access to content hosted on third-party websites. It does not host, upload, store, or distribute any media itself.

This software is not intended to promote piracy or copyright infringement. You are solely responsible for how you use AniWorld Downloader and for ensuring that your use complies with applicable laws and the terms of service of the websites you access.

The developer provides this project "as is" and is not responsible for:

• Third-party content
• External links
• The availability, accuracy, legality, or reliability of any third-party service

If you have concerns about specific content, contact the relevant website owner, administrator, or hosting provider.

(back to top)

Star History

(back to top)

License

This project is licensed under the MIT License. For full terms and conditions, please see the LICENSE file included with this project.