<a id="readme-top"></a>
# AniWorld Downloader
AniWorld Downloader is a command-line tool for downloading and streaming content from aniworld.to and s.to. Currently available for Windows, macOS and Linux, it supports LoadX, VOE, Vidmoly, Filemoon, Luluvdo, Doodstream, Vidoza, SpeedFiles and Streamtape.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## 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.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## :construction: Documentation :construction:
I am currently working on a documentation for AniWorld Downloader, which you can access here:
[https://www.phoenixthrush.com/AniWorld-Downloader-Docs/](https://www.phoenixthrush.com/AniWorld-Downloader-Docs/)
The documentation is a work in progress, so feel free to check back from time to time for updates and new information.
Most information in this README is already available in more detail on the documentation website. In the future, this README will be simplified to only give a basic overview.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Supported Providers
To see the list of supported providers, check the [SUPPORTED_PROVIDERS](https://github.com/phoenixthrush/AniWorld-Downloader/blob/dfbe431cb9bfbb315e22185b5cb63e06e7cd6277/src/aniworld/config.py#L100C11-L102C) variable.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Installation
### Prerequisites
Ensure you have **[Python 3.9](https://www.python.org/downloads/)** or higher installed.<br>
Additionally, make sure **[Git](https://git-scm.com/downloads)** is installed if you plan to install the development version.
**Note**: If you are using an ARM-based system, you might face issues with the curses module. To resolve this, use the amd64 [Python version](https://www.python.org/ftp/python/3.12.7/python-3.12.7-amd64.exe) instead of the ARM version. For more details, refer to [GitHub Issue #14](https://github.com/phoenixthrush/AniWorld-Downloader/issues/14).
<details>
<summary>Python Installation Tutorial (Windows)</summary>
<img src="https://github.com/phoenixthrush/AniWorld-Downloader/blob/next/.github/assets/Python_Add_to_Path_Tutorial.png?raw=true" alt="Python Installation Tutorial">
**Note:** If you've restarted the terminal and `aniworld` isn't being recognized, you have two options:
- Add `aniworld` to your PATH so it can be found globally.
- Run `python -m aniworld`, which should work without adding it to the PATH.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
</details>
### Installation
#### Install Latest Stable Release (Recommended)
To install the latest stable version directly from GitHub, use the following command:
```shell
pip install --upgrade aniworld
```
#### Install Latest Development Version (Requires Git)
To install the latest development version directly from GitHub, use the following command:
```shell
pip install --upgrade git+https://github.com/phoenixthrush/AniWorld-Downloader.git@next#egg=aniworld
```
Re-run this command periodically to update to the latest development build. These builds are from the `next` branch and may include experimental or unstable changes.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
#### Local Installation (Requires Git)
For a local installation, follow these steps:
1. Clone the repository:
```shell
git clone https://github.com/phoenixthrush/AniWorld-Downloader aniworld
```
2. Install the package in editable mode:
```shell
pip install -U -e ./aniworld
```
3. To update your local version, run:
```shell
git -C aniworld pull
```
<p align="right">(<a href="#readme-top">back to top</a>)</p>
#### Executable Releases
You don't need Python installed to use the binary builds of AniWorld available on GitHub.
[Releases](https://github.com/phoenixthrush/AniWorld-Downloader/releases/latest)
<p align="right">(<a href="#readme-top">back to top</a>)</p>
### Uninstallation
To uninstall AniWorld Downloader, run the following command:
```shell
pip --uninstall aniworld
```
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## 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 or streams.
2. **Command-Line Arguments**: Execute specific tasks directly by providing arguments, such as downloading a particular episode or setting preferences.
3. **Python Library**: Integrate AniWorld Downloader into your Python projects to programmatically manage anime, series, or movie downloads.
Choose the method that best suits your workflow and enjoy a seamless experience!
### Menu Example
To start the interactive menu, simply run:
```shell
aniworld
```
### Command-Line Arguments Example
AniWorld Downloader provides a variety of command-line options for downloading and streaming 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":
```shell
aniworld --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":
```shell
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
```
#### Example 3: Watch Episodes with Aniskip
To watch an episode while skipping intros and outros:
```shell
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Watch --aniskip
```
#### Example 4: Syncplay with Friends
To syncplay a specific episode with friends:
```shell
aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching
```
#### Language Options for Syncplay
You can select different languages for yourself and your friends:
- For German Dub:
```shell
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:
```shell
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:** Syncplay automatically groups users watching the same anime (regardless of episode). To restrict access, set a password for the room:
```shell
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
```
#### Example 5: Download with Specific Provider and Language
To download an episode using the VOE provider with English subtitles:
```shell
aniworld --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:
```shell
aniworld --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.
#### Example 7: Use a custom provider URL
Download a provider link. It's important to note that you also need to specify the provider manually.
```shell
aniworld --provider-link https://voe.sx/e/ayginbzzb6bi --provider VOE
```
<p align="right">(<a href="#readme-top">back to top</a>)</p>
### Library Example
You can also use AniWorld Downloader as a library in your Python scripts to programmatically manage anime downloads or streams. Here's an example:
```python
from aniworld.models import Anime, Episode
# Define an Anime object with a list of episodes
anime = Anime(
episode_list=[
Episode(
slug="food-wars-shokugeki-no-sma",
season=1,
episode=5
),
Episode(
link="https://aniworld.to/anime/stream/food-wars-shokugeki-no-sma/staffel-1/episode-6"
)
]
)
# Iterate through the episodes and retrieve direct links
for episode in anime:
print(f"Episode: {episode}")
print(f"Direct Link: {episode.get_direct_link('VOE', 'German Sub')}")
```
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Anime4K Setup
Enhance your anime viewing experience with Anime4K. Follow the instructions below to configure Anime4K for use with the mpv player, even outside of AniWorld Downloader.
### For High-Performance GPUs
*(Examples: GTX 1080, RTX 2070, RTX 3060, RX 590, Vega 56, 5700XT, 6600XT, M1 Pro/Max/Ultra, M2 Pro/Max)*
Run the following command to optimize Anime4K for high-end GPUs:
```shell
aniworld --anime4k High
```
### For Low-Performance GPUs
*(Examples: GTX 980, GTX 1060, RX 570, M1, M2, Intel integrated GPUs)*
Run the following command to configure Anime4K for low-end GPUs:
```shell
aniworld --anime4k Low
```
### Uninstall Anime4K
To remove Anime4K from your setup, use this command:
```shell
aniworld --anime4k Remove
```
### Additional Information
All files for Anime4K are saved in the **mpv** directory during installation.
- **Windows**: `C:\Users\<YourUsername>\AppData\Roaming\mpv`
- **macOS**: `/Users/<YourUsername>/.config/mpv`
- **Linux**: `/home/<YourUsername>/.config/mpv`
You can switch between `High` and `Low` modes at any time to match your GPU's performance. To cleanly uninstall Anime4K, use the `Remove` option.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## 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 using `pip`.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Credits
- **[mpv](https://github.com/mpv-player/mpv.git)**: A versatile media player used for seamless streaming.
- **[yt-dlp](https://github.com/yt-dlp/yt-dlp.git)**: A powerful tool for downloading videos from various providers.
- **[Syncplay](https://github.com/Syncplay/syncplay.git)**: Enables synchronized playback sessions with friends.
- **[Anime4K](https://github.com/bloc97/Anime4K)**: A cutting-edge real-time upscaler for enhancing anime video quality.
- **[Aniskip](https://api.aniskip.com/api-docs)**: Provides the opening and ending skip times for the Aniskip extension.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## 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
<a href="https://github.com/phoenixthrush/Aniworld-Downloader/graphs/contributors">
<img src="https://contrib.rocks/image?repo=phoenixthrush/Aniworld-Downloader" alt="Contributors" />
</a>
- **Lulu** (since Sep 14, 2024)
- **Tmaster055** (since Oct 21, 2024)
Special thanks to [Tmaster055](https://github.com/Tmaster055) for resolving the Aniskip issue by correctly fetching the MAL ID!
Additional thanks to [fundyjo](https://github.com/fundyjo) for contributing the Doodstream extractor!
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Support
If you need help with AniWorld Downloader, you can:
- **Submit an issue** on the [GitHub Issues](https://github.com/phoenixthrush/AniWorld-Downloader/issues) page.
- **Reach out directly** via email at [contact@phoenixthrush.com](mailto:contact@phoenixthrush.com) or on Discord at `phoenixthrush` or `tmaster067`.
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!
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## 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.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Star History
[](https://star-history.com/#phoenixthrush/Aniworld-Downloader&Date)
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## License
This project is licensed under the **[MIT License](LICENSE)**.
For more details, see the LICENSE file.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
Raw data
{
"_id": null,
"home_page": null,
"name": "aniworld",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Phoenixthrush UwU <contact@phoenixthrush.com>",
"keywords": "anime, aniworld, anime-downloader, aniworld-downloader, streaming, download, video, multimedia, cli",
"author": null,
"author_email": "Phoenixthrush UwU <contact@phoenixthrush.com>",
"download_url": "https://files.pythonhosted.org/packages/2c/09/a0944888a8402aefbd901df64e1acfdcd563e3f2add1dcd06eb3e79a298a/aniworld-3.4.1.tar.gz",
"platform": null,
"description": "<a id=\"readme-top\"></a>\n# AniWorld Downloader\n\nAniWorld Downloader is a command-line tool for downloading and streaming content from aniworld.to and s.to. Currently available for Windows, macOS and Linux, it supports LoadX, VOE, Vidmoly, Filemoon, Luluvdo, Doodstream, Vidoza, SpeedFiles and Streamtape.\n\n\n\n\n\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Features\n\n- **Download Episodes or Seasons**: Effortlessly download individual episodes or entire seasons with a single command.\n- **Stream Instantly**: Watch episodes directly using the integrated mpv player for a seamless experience.\n- **Auto-Next Playback**: Enjoy uninterrupted viewing with automatic transitions to the next episode.\n- **Multiple Providers**: Access a variety of streaming providers on aniworld.to for greater flexibility.\n- **Language Preferences**: Easily switch between German Dub, English Sub, or German Sub to suit your needs.\n- **Aniskip Support**: Automatically skip intros and outros for a smoother viewing experience.\n- **Group Watching with Syncplay**: Host synchronized anime sessions with friends using Syncplay integration.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## :construction: Documentation :construction:\n\nI am currently working on a documentation for AniWorld Downloader, which you can access here:\n[https://www.phoenixthrush.com/AniWorld-Downloader-Docs/](https://www.phoenixthrush.com/AniWorld-Downloader-Docs/)\n\nThe documentation is a work in progress, so feel free to check back from time to time for updates and new information.\n\nMost information in this README is already available in more detail on the documentation website. In the future, this README will be simplified to only give a basic overview.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Supported Providers\n\nTo see the list of supported providers, check the [SUPPORTED_PROVIDERS](https://github.com/phoenixthrush/AniWorld-Downloader/blob/dfbe431cb9bfbb315e22185b5cb63e06e7cd6277/src/aniworld/config.py#L100C11-L102C) variable.\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Installation\n\n### Prerequisites\n\nEnsure you have **[Python 3.9](https://www.python.org/downloads/)** or higher installed.<br>\nAdditionally, make sure **[Git](https://git-scm.com/downloads)** is installed if you plan to install the development version.\n\n**Note**: If you are using an ARM-based system, you might face issues with the curses module. To resolve this, use the amd64 [Python version](https://www.python.org/ftp/python/3.12.7/python-3.12.7-amd64.exe) instead of the ARM version. For more details, refer to [GitHub Issue #14](https://github.com/phoenixthrush/AniWorld-Downloader/issues/14).\n\n<details>\n <summary>Python Installation Tutorial (Windows)</summary>\n <img src=\"https://github.com/phoenixthrush/AniWorld-Downloader/blob/next/.github/assets/Python_Add_to_Path_Tutorial.png?raw=true\" alt=\"Python Installation Tutorial\">\n\n**Note:** If you've restarted the terminal and `aniworld` isn't being recognized, you have two options:\n- Add `aniworld` to your PATH so it can be found globally.\n- Run `python -m aniworld`, which should work without adding it to the PATH.\n \n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n</details>\n\n### Installation\n\n#### Install Latest Stable Release (Recommended)\n\nTo install the latest stable version directly from GitHub, use the following command:\n\n```shell\npip install --upgrade aniworld\n```\n\n#### Install Latest Development Version (Requires Git)\n\nTo install the latest development version directly from GitHub, use the following command:\n\n```shell\npip install --upgrade git+https://github.com/phoenixthrush/AniWorld-Downloader.git@next#egg=aniworld\n```\n\nRe-run this command periodically to update to the latest development build. These builds are from the `next` branch and may include experimental or unstable changes.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n#### Local Installation (Requires Git)\n\nFor a local installation, follow these steps:\n\n1. Clone the repository:\n\n ```shell\n git clone https://github.com/phoenixthrush/AniWorld-Downloader aniworld\n ```\n\n2. Install the package in editable mode:\n\n ```shell\n pip install -U -e ./aniworld\n ```\n\n3. To update your local version, run:\n\n ```shell\n git -C aniworld pull\n ```\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n#### Executable Releases\n\nYou don't need Python installed to use the binary builds of AniWorld available on GitHub.\n\n[Releases](https://github.com/phoenixthrush/AniWorld-Downloader/releases/latest)\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n### Uninstallation\n\nTo uninstall AniWorld Downloader, run the following command:\n\n```shell\npip --uninstall aniworld\n```\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Usage\n\nAniWorld Downloader offers three versatile usage modes:\n\n1. **Interactive Menu**: Launch the tool and navigate through an intuitive menu to select and manage downloads or streams.\n2. **Command-Line Arguments**: Execute specific tasks directly by providing arguments, such as downloading a particular episode or setting preferences.\n3. **Python Library**: Integrate AniWorld Downloader into your Python projects to programmatically manage anime, series, or movie downloads.\n\nChoose the method that best suits your workflow and enjoy a seamless experience!\n\n### Menu Example\n\nTo start the interactive menu, simply run:\n\n```shell\naniworld\n```\n\n### Command-Line Arguments Example\n\nAniWorld Downloader provides a variety of command-line options for downloading and streaming anime without relying on the interactive menu. These options unlock advanced features such as `--aniskip`, `--keep-watching`, and `--syncplay-password`.\n\n#### Example 1: Download a Single Episode\n\nTo download episode 1 of \"Demon Slayer: Kimetsu no Yaiba\":\n\n```shell\naniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1\n```\n\n#### Example 2: Download Multiple Episodes\n\nTo download multiple episodes of \"Demon Slayer\":\n\n```shell\naniworld --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\n```\n\n#### Example 3: Watch Episodes with Aniskip\n\nTo watch an episode while skipping intros and outros:\n\n```shell\naniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Watch --aniskip\n```\n\n#### Example 4: Syncplay with Friends\n\nTo syncplay a specific episode with friends:\n\n```shell\naniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching\n```\n\n#### Language Options for Syncplay\n\nYou can select different languages for yourself and your friends:\n\n- For German Dub:\n\n ```shell\n aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching --language \"German Dub\" --aniskip\n ```\n\n- For English Sub:\n\n ```shell\n aniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --action Syncplay --keep-watching --language \"English Sub\" --aniskip\n ```\n\n**Note:** Syncplay automatically groups users watching the same anime (regardless of episode). To restrict access, set a password for the room:\n\n```shell\naniworld --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\n```\n\n#### Example 5: Download with Specific Provider and Language\n\nTo download an episode using the VOE provider with English subtitles:\n\n```shell\naniworld --episode https://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-1/episode-1 --provider VOE --language \"English Sub\"\n```\n\n#### Example 6: Use an Episode File\n\nYou can download episodes listed in a text file. Below is an example of a text file (`test.txt`):\n\n```\n# The whole anime\nhttps://aniworld.to/anime/stream/alya-sometimes-hides-her-feelings-in-russian\n\n# The whole Season 2\nhttps://aniworld.to/anime/stream/demon-slayer-kimetsu-no-yaiba/staffel-2\n\n# Only Season 3 Episode 13\nhttps://aniworld.to/anime/stream/kaguya-sama-love-is-war/staffel-3/episode-13\n```\n\nTo download the episodes specified in the file, use:\n\n```shell\naniworld --episode-file test.txt --language \"German Dub\"\n```\n\nThis can also be combined with `Watch` and `Syncplay` actions, as well as other arguments, for a more customized experience.\n\n#### Example 7: Use a custom provider URL\n\nDownload a provider link. It's important to note that you also need to specify the provider manually.\n\n```shell\naniworld --provider-link https://voe.sx/e/ayginbzzb6bi --provider VOE\n```\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n### Library Example\n\nYou can also use AniWorld Downloader as a library in your Python scripts to programmatically manage anime downloads or streams. Here's an example:\n\n```python\nfrom aniworld.models import Anime, Episode\n\n# Define an Anime object with a list of episodes\nanime = Anime(\n episode_list=[\n Episode(\n slug=\"food-wars-shokugeki-no-sma\",\n season=1,\n episode=5\n ),\n Episode(\n link=\"https://aniworld.to/anime/stream/food-wars-shokugeki-no-sma/staffel-1/episode-6\"\n )\n ]\n)\n\n# Iterate through the episodes and retrieve direct links\nfor episode in anime:\n print(f\"Episode: {episode}\")\n print(f\"Direct Link: {episode.get_direct_link('VOE', 'German Sub')}\")\n```\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Anime4K Setup\n\nEnhance your anime viewing experience with Anime4K. Follow the instructions below to configure Anime4K for use with the mpv player, even outside of AniWorld Downloader.\n\n### For High-Performance GPUs\n*(Examples: GTX 1080, RTX 2070, RTX 3060, RX 590, Vega 56, 5700XT, 6600XT, M1 Pro/Max/Ultra, M2 Pro/Max)*\n\nRun the following command to optimize Anime4K for high-end GPUs:\n\n```shell\naniworld --anime4k High\n```\n\n### For Low-Performance GPUs\n*(Examples: GTX 980, GTX 1060, RX 570, M1, M2, Intel integrated GPUs)*\n\nRun the following command to configure Anime4K for low-end GPUs:\n\n```shell\naniworld --anime4k Low\n```\n\n### Uninstall Anime4K\nTo remove Anime4K from your setup, use this command:\n\n```shell\naniworld --anime4k Remove\n```\n\n### Additional Information\n\nAll files for Anime4K are saved in the **mpv** directory during installation. \n\n- **Windows**: `C:\\Users\\<YourUsername>\\AppData\\Roaming\\mpv`\n- **macOS**: `/Users/<YourUsername>/.config/mpv`\n- **Linux**: `/home/<YourUsername>/.config/mpv`\n\nYou can switch between `High` and `Low` modes at any time to match your GPU's performance. To cleanly uninstall Anime4K, use the `Remove` option.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Dependencies\n\nAniWorld Downloader depends on the following Python packages:\n\n- **`requests`**: For handling HTTP requests.\n- **`beautifulsoup4`**: For parsing and scraping HTML content.\n- **`yt-dlp`**: For downloading videos from supported providers.\n- **`npyscreen`**: For creating interactive terminal-based user interfaces.\n- **`tqdm`**: For providing progress bars during downloads.\n- **`fake_useragent`**: For generating random user-agent strings.\n- **`packaging`**: For parsing version numbers and handling package versions.\n- **`jsbeautifier`**: Used for the Filemoon extractor.\n- **`py-cpuinfo`**: Only required on Windows for gathering CPU information (AVX2 support for MPV).\n- **`windows-curses`**: Required on Windows systems to enable terminal-based UI functionality.\n\nThese dependencies are automatically installed when you set up AniWorld Downloader using `pip`.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Credits\n\n- **[mpv](https://github.com/mpv-player/mpv.git)**: A versatile media player used for seamless streaming.\n- **[yt-dlp](https://github.com/yt-dlp/yt-dlp.git)**: A powerful tool for downloading videos from various providers.\n- **[Syncplay](https://github.com/Syncplay/syncplay.git)**: Enables synchronized playback sessions with friends.\n- **[Anime4K](https://github.com/bloc97/Anime4K)**: A cutting-edge real-time upscaler for enhancing anime video quality.\n- **[Aniskip](https://api.aniskip.com/api-docs)**: Provides the opening and ending skip times for the Aniskip extension.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Contributing\n\nContributions to AniWorld Downloader are highly appreciated! You can help enhance the project by:\n\n- **Reporting Bugs**: Identify and report issues to improve functionality.\n- **Suggesting Features**: Share ideas to expand the tool's capabilities.\n- **Submitting Pull Requests**: Contribute code to fix bugs or add new features.\n\n### Contributors\n\n<a href=\"https://github.com/phoenixthrush/Aniworld-Downloader/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=phoenixthrush/Aniworld-Downloader\" alt=\"Contributors\" />\n</a>\n\n- **Lulu** (since Sep 14, 2024) \n \n\n- **Tmaster055** (since Oct 21, 2024) \n \n\n Special thanks to [Tmaster055](https://github.com/Tmaster055) for resolving the Aniskip issue by correctly fetching the MAL ID! \n Additional thanks to [fundyjo](https://github.com/fundyjo) for contributing the Doodstream extractor!\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Support\n\nIf you need help with AniWorld Downloader, you can:\n\n- **Submit an issue** on the [GitHub Issues](https://github.com/phoenixthrush/AniWorld-Downloader/issues) page.\n- **Reach out directly** via email at [contact@phoenixthrush.com](mailto:contact@phoenixthrush.com) or on Discord at `phoenixthrush` or `tmaster067`.\n\nWhile 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\u2019s your preference.\n\nIf you find AniWorld Downloader useful, consider starring the repository on GitHub. Your support is greatly appreciated and inspires continued development.\n\nThank you for using AniWorld Downloader!\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Legal Disclaimer\n\nAniWorld Downloader is made for accessing content that\u2019s already publicly available online. It doesn\u2019t support or promote piracy or copyright violations. The developer isn\u2019t responsible for how the tool is used or for any content found through external links.\n\nAll content accessed with AniWorld Downloader is available on the internet, and the tool itself doesn\u2019t host or share copyrighted files. It also has no control over the accuracy, legality, or availability of the websites it links to.\n\nIf you have concerns about any content accessed through this tool, please reach out directly to the website\u2019s owner, admin, or hosting provider. Thanks for your understanding.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Star History\n\n[](https://star-history.com/#phoenixthrush/Aniworld-Downloader&Date)\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## License\n\nThis project is licensed under the **[MIT License](LICENSE)**. \nFor more details, see the LICENSE file.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "AniWorld Downloader is a command-line tool for downloading and streaming anime, series and movies, compatible with Windows, macOS, and Linux.",
"version": "3.4.1",
"project_urls": {
"Bug Tracker": "https://github.com/phoenixthrush/AniWorld-Downloader/issues",
"Changelog": "https://github.com/phoenixthrush/AniWorld-Downloader/commits",
"Documentation": "https://github.com/phoenixthrush/AniWorld-Downloader/blob/main/README.md",
"Download": "https://github.com/phoenixthrush/AniWorld-Downloader/archive/refs/heads/main.zip",
"Funding": "https://github.com/sponsors/phoenixthrush",
"Homepage": "https://github.com/phoenixthrush/AniWorld-Downloader",
"Repository": "https://github.com/phoenixthrush/AniWorld-Downloader.git",
"Source Code": "https://github.com/phoenixthrush/AniWorld-Downloader"
},
"split_keywords": [
"anime",
" aniworld",
" anime-downloader",
" aniworld-downloader",
" streaming",
" download",
" video",
" multimedia",
" cli"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fcc21fb5b6c4bcf39c454574126a1281cec6592f3127d751c05c81a37e079c16",
"md5": "c09f1f47e9e68f37e0b20087a9c1deba",
"sha256": "287c83b5173df9db52898b06dab746e814d59c5e753b2a834f68877691d2e1a1"
},
"downloads": -1,
"filename": "aniworld-3.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c09f1f47e9e68f37e0b20087a9c1deba",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 103294,
"upload_time": "2025-08-03T18:08:46",
"upload_time_iso_8601": "2025-08-03T18:08:46.239201Z",
"url": "https://files.pythonhosted.org/packages/fc/c2/1fb5b6c4bcf39c454574126a1281cec6592f3127d751c05c81a37e079c16/aniworld-3.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2c09a0944888a8402aefbd901df64e1acfdcd563e3f2add1dcd06eb3e79a298a",
"md5": "5e665b1e04375fece37301723c3816b5",
"sha256": "7a25535a1a222d5d07b620505e93ec770a6f20ccd9ef1ccd35bec75d9fbdd2df"
},
"downloads": -1,
"filename": "aniworld-3.4.1.tar.gz",
"has_sig": false,
"md5_digest": "5e665b1e04375fece37301723c3816b5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 94910,
"upload_time": "2025-08-03T18:08:48",
"upload_time_iso_8601": "2025-08-03T18:08:48.082744Z",
"url": "https://files.pythonhosted.org/packages/2c/09/a0944888a8402aefbd901df64e1acfdcd563e3f2add1dcd06eb3e79a298a/aniworld-3.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-03 18:08:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "phoenixthrush",
"github_project": "AniWorld-Downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "aniworld"
}
JSON
