🎬 Anime Downloader

A simple Streamlit-based tool for downloading anime episodes from supported websites.

---

📦 Env Setup

1. Requirements

• Python >= 3.11
• uv (for environment management)
• Git

2. Install uv

If you don’t have uv installed yet:

pip install uv

3. Clone/Download the project

git clone <project-url>
cd video-script

4. Install project dependencies

uv sync

5. Activate the virtual environment

Linux / MacOS:

source .venv/bin/activate

Windows(PowerShell):

.venv\Scripts\Activate.ps1

Windows(cmd):

.venv\Scripts\activate.bat

---

🚀 How to Use

1. Activate your virtual environment

   Make sure your Python virtual environment is activated.

2. Run the app

   In the project root directory, run:

   streamlit run ./frontend.py

3. Open the Web Interface

   Streamlit will automatically open a new browser tab.
   If it doesn’t, copy the provided local URL (e.g., http://localhost:8501) and open it manually.

4. Download Episodes

• Paste the anime series URL into the input box and press Enter
• Select one or multiple episodes (or use the Select All option)
• Click the Download Selected Episodes button to start downloading
• Click the Download ZIP button to download zip file to local
• ⚠️ Important!!!! If the Clear Cache button appeared, please HIT it to remove cache on server

---

🐞 Feedback & Bug Reports

If you run into any issues or unexpected behavior, just send me a message. Your feedback helps improve this tool — contributions and suggestions are always welcome!