AniWorld Downloader for Docker

AniWorld Downloader is a versatile command-line tool designed for downloading and streaming anime, series, and movies. It supports Windows, macOS, and Linux, offering a seamless experience across platforms.

(back to top)

Features

• Download Episodes or Seasons: Effortlessly download individual episodes or entire seasons with a single command.
• Stream Instantly: Watch episodes directly using the integrated mpv player for a seamless experience.
• Auto-Next Playback: Enjoy uninterrupted viewing with automatic transitions to the next episode.
• Multiple Providers: Access a variety of streaming providers on aniworld.to for greater flexibility.
• Language Preferences: Easily switch between German Dub, English Sub, or German Sub to suit your needs.
• Aniskip Support: Automatically skip intros and outros for a smoother viewing experience.
• Group Watching with Syncplay: Host synchronized anime sessions with friends using Syncplay integration.

(back to top)

Supported Providers

To see the list of supported providers, check the SUPPORTED_PROVIDERS variable.

(back to top)

Installation

Prerequisites

Ensure you have Docker and Docker Compose.
Additionally, you can use Portainer to deploy your compose as a stack.

Docker-Compose

services:
  aniworld-downloader:
    image: ghcr.io/m4rc-xx/aniworld-downloader-docker:next
    container_name: aniworld-downloader
    tty: true
    stdin_open: true
    volumes:
      - <PATH-FOR-DOWNLOADS>:/app/downloads
     #EXAMPLE
     #- /home/pi/aniworld-downloads:/app/downloads
    restart: unless-stopped

(back to top)

Usage

AniWorld Downloader offers three versatile usage modes:

1. Interactive Menu: Launch the tool and navigate through an intuitive menu to select and manage downloads.
2. Command-Line Arguments: Execute specific tasks directly by providing arguments, such as downloading a particular episode or setting preferences.

Choose the method that best suits your workflow and enjoy a seamless experience!

to execute into the container

docker exec -it aniworld-downloader /bin/bash

Menu Example

To start the interactive menu, simply run:

aniworld --output-dir /app/downloads

Command-Line Arguments Example

AniWorld Downloader provides a variety of command-line options for downloading anime without relying on the interactive menu. These options unlock advanced features such as --aniskip, --keep-watching, and --syncplay-password.

Example 1: Download a Single Episode

To download episode 1 of "Demon Slayer: Kimetsu no Yaiba":

aniworld --output-dir /app/downloads --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1

Example 2: Download Multiple Episodes

To download multiple episodes of "Demon Slayer":

aniworld --output-dir /app/downloads --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

~Example 3: Watch Episodes with Aniskip~

~Example 4: Syncplay with Friends~

Example 5: Download with Specific Provider and Language

To download an episode using the VOE provider with English subtitles:

aniworld --output-dir /app/downloads --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --provider VOE --language "English Sub"

Example 6: Use an Episode File

You can download episodes listed in a text file. Below is an example of a text file (test.txt):

# 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 --output-dir /app/downloads --episode-file test.txt --language "German Dub"

~~~This can also be combined with Watch and Syncplay actions, as well as other arguments, for a more customized experience.~~~

(back to top)

Dependencies

AniWorld Downloader depends on the following Python packages:

• requests: For handling HTTP requests.
• beautifulsoup4: For parsing and scraping HTML content.
• yt-dlp: For downloading videos from supported providers.
• npyscreen: For creating interactive terminal-based user interfaces.
• tqdm: For providing progress bars during downloads.
• fake_useragent: For generating random user-agent strings.
• packaging: For parsing version numbers and handling package versions.
• jsbeautifier: Used for the Filemoon extractor.
• py-cpuinfo: Only required on Windows for gathering CPU information (AVX2 support for MPV).
• windows-curses: Required on Windows systems to enable terminal-based UI functionality.

These dependencies are automatically installed when you set up AniWorld Downloader.

(back to top)

Credits

• phoenixthrush: for this amazing project <3.
• mpv: A versatile media player used for seamless streaming.
• yt-dlp: A powerful tool for downloading videos from various providers.
• Syncplay: Enables synchronized playback sessions with friends.
• Anime4K: A cutting-edge real-time upscaler for enhancing anime video quality.
• Aniskip: Provides the opening and ending skip times for the Aniskip extension.

(back to top)

Contributing

Contributions to AniWorld Downloader are highly appreciated! You can help enhance the project by:

• Reporting Bugs: Identify and report issues to improve functionality.
• Suggesting Features: Share ideas to expand the tool's capabilities.
• Submitting Pull Requests: Contribute code to fix bugs or add new features.

Contributors

• Lulu (since Sep 14, 2024)
  

• Tmaster055 (since Oct 21, 2024)
  

  Special thanks to Tmaster055 for resolving the Aniskip issue by correctly fetching the MAL ID!
  Additional thanks to fundyjo for contributing the Doodstream extractor!

(back to top)

Support

If you need help with AniWorld Downloader, you can:

• Submit an issue on the GitHub Issues page.
• Reach out directly via email at contact@phoenixthrush.com or on Discord at phoenixthrush.

While email support is available, opening a GitHub issue is preferred, even for installation-related questions, as it helps others benefit from shared solutions. However, feel free to email if that’s your preference.

If you find AniWorld Downloader useful, consider starring the repository on GitHub. Your support is greatly appreciated and inspires continued development.

Thank you for using AniWorld Downloader!

(back to top)

Legal Disclaimer

AniWorld Downloader is made for accessing content that’s already publicly available online. It doesn’t support or promote piracy or copyright violations. The developer isn’t responsible for how the tool is used or for any content found through external links.

All content accessed with AniWorld Downloader is available on the internet, and the tool itself doesn’t host or share copyrighted files. It also has no control over the accuracy, legality, or availability of the websites it links to.

If you have concerns about any content accessed through this tool, please reach out directly to the website’s owner, admin, or hosting provider. Thanks for your understanding.

(back to top)

Star History of the main project

(back to top)

License

This project is licensed under the MIT License.
For more details, see the LICENSE file.

(back to top)