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

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.

Documentation

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

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

Still in Development

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

• implement GLOBAL_SESSION imports lazy loading
• fix episode download cleanup on KeyboardInterrupt in menu
• add support for aniskip feature on IINA
• Split Web UI SSO dependencies into separate extras section
• 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

Supported Providers

Provider	Status	Last Tested
VOE	✅ Working	07/26
Vidoza	✅ Working	02/26
Vidmoly	✅ Working	02/26
Doodstream	✅ Working	07/26
Filemoon	❌ Broken	02/26
Hanime	⏳ Not Implemented	—
LoadX	⏳ Not Implemented	—
Luluvdo	⏳ Not Implemented	—
Streamtape	⏳ Not Implemented	—

Currently Prioritized Providers

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

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.

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)
  

Dependencies

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

Core dependencies

• niquests – HTTP 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
• rich – Styled terminal output
• fake-useragent – Generates user-agent strings
• packaging – Version parsing and comparison
• cryptography – Cryptographic utilities
• patchright – Browser automation support for captcha handling

Web / server dependencies

• requests – Standard HTTP library
• flask – Web framework
• flask-wtf – Forms and CSRF protection for Flask
• authlib – OAuth and authentication helpers
• waitress – Production WSGI server

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 dependencies are installed automatically when AniWorld Downloader is installed with pip.

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

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.

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!

Legal Disclaimer