Anime-Sama-Downloader

A fast and efficient downloader for anime from Anime-Sama.

Table of Contents

• Anime-Sama-Downloader
  • Installation
    • Playwright Installation
  • Usage
  • Important Warning
  • Recent Updates
  • Contributing
  • Troubleshooting
  • Stat Dashboard
  • Demo
  • Star History

Installation

Important

This project requires Git to be installed.
Download: here

1. Clone the repository with submodules:

git clone https://github.com/TMCooper/Anime-Sama-Downloader.git --recurse-submodules

2. Run the setup:

python setup.py

3. Launch the application (after entering the environment):

python main.py

Note

• To launch in debug mode, simply run:

  python main.py --debug

• To launch the API with a specific IP and port, run:

  python main.py --ip 127.0.0.1 --port 5001

  Or using shorthand options:

  python main.py -i 127.0.0.1 -p 5001

• You can also specify only the IP or only the port:

  python main.py --ip 127.0.0.1
  python main.py --port 5001

Playwright Installation

If you see this message after installation:

Looks like Playwright was just installed or updated.
Please run the following command to download new browsers:
playwright install

Simply run (in your virtual environment):

playwright install

Usage

Important

If your anime's name contains, for example, "season name," "remake 2024," or something similar, then copy and paste that same name. For example, if you want to play season 1 part 1 "Cinderella Gray" for anime, enter the same name but choose "other image," for example here.

1. Verify your anime exists on Anime-Sama
2. Launch main.py
3. Enter the anime name (e.g., "Frieren")
4. choose between saison (season) film (movie), oav and autre (other)
   • Note: If you choose saison (season) keep in mind that if the field is empty, it will default to the first season
5. Choose the version: vostfr or vf

The downloader will automatically process your request and stop when it's complete.

Important Warning

Rate Limiting: Downloading too many anime in a short period may result in a temporary ban.

Recommended: Maximum of 2 anime downloads per hour.

Recent Updates

• Update submodule
• New system for update notifications and anonymous stats collection here. (The file ressources/Utils/statsChoices.json will be created at first run. You can change your choice anytime by editing it: replace "yes"/"oui" with "no"/"non".)
• Added argument system: debug (--debug), IP (-i), Port (-p)
• Complete project rework using a new API : AnimeSamaApi

Contributing

Have an idea ? Share it in our Ideas Discussion!

Troubleshooting

• Reclone the project Delete the project folder and clone it again from the repository.

• Reset the cached data, Go to: AnimeSamaApi/src/data/json and then delete the file: AnimeInfo.json, After that, try running main.py again from the root folder.

Stat Dashboard

You can acces de site here and for any issue you can go to the repo here

Demo

Star History