aniworld 4.1.0

AniWorld-Downloader is a command-line tool for downloading and streaming movies and series.

AniWorld Downloader v4

AniWorld Downloader is a cross-platform tool for streaming and downloading anime from aniworld.to, as well as series from s.to. It runs on Windows, macOS, and Linux, providing a seamless experience for offline viewing or instant playback.

(back to top)

TL;DR - Quick Start

# Install stable release
pip install -U aniworld

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

# Launch AniWorld Downloader
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)

Still in Development

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

• Split Web UI SSO dependencies into separate extras section
• Implement keep-watching argument for continuous playback
• Review and optimize dependency manager on Windows
• 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)

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
• Docker Ready – Deploy easily using Docker or Docker Compose

(back to top)

Supported Providers

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

Currently Prioritized Providers

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

(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)

Documentation

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

(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 requires several Python packages for HTTP requests, UI, media processing, web features, and environment management.

Core dependencies

• niquests – Simplified HTTP requests
• npyscreen – For building interactive text-based UIs (TUI)
• ffmpeg-python – Python bindings for FFmpeg (requires FFmpeg installed on your system)
• python-dotenv – Loads environment variables from a .env file
• rich – Colored and formatted terminal output (used by aniworld --examples)
• fake-useragent – Generates random user agents (optional, may be replaced in the future)

Web / server dependencies

• requests – Standard HTTP library for Python
• flask – Lightweight web framework
• flask-wtf – Form handling and CSRF protection for Flask
• authlib – OAuth and authentication utilities
• waitress – Production-ready WSGI server

Platform-specific dependencies

• windows-curses – Enables curses support required by npyscreen on Windows (installed automatically on Windows; version pinned for Python < 3.14)

All dependencies are installed automatically when AniWorld Downloader is installed via 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

(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 [e-mail] 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.