Skip to content

WimWamWom/AniLoader

BranchesTags

Repository files navigation

AniLoader

Anime & Serien Download-Manager mit Web-Interface Automatisches Herunterladen von aniworld.to und s.to mit Jellyfin-Struktur

TL;DR

# Docker starten (empfohlen)
docker run -d -p 5050:5050 -v ./data:/app/data -v ./Downloads:/app/Downloads wimwamwom/aniloader:latest

# Web-Interface öffnen: http://localhost:5050
# Serie hinzufügen → Download-Modus wählen → Fertig!

Das wars! AniLoader lädt Anime/Serien automatisch herunter, benennt sie für Jellyfin um und verwaltet alles über eine Web-Oberfläche.

Inhaltsübersicht

Funktionen

  • 🌐 Web-Interface: Moderne Dark-Theme Oberfläche mit Live-Status
  • 📥 5 Download-Modi: Default, German, New Episode Check, German+New, Integrity Check
  • 🤖 Automation: Geplante Läufe per Cron-Schedule oder Intervall mit Discord-Benachrichtigungen
  • 🔍 Suche + Poster: Durchsuche Aniworld und SerieStream
  • 🇩🇪 Sprach-Priorität: German Dub → Sub → English (automatischer Fallback)
  • 📁 Jellyfin-Ready: Title (Year) [IMDB]/Season/Episode.mkv
  • 💾 Persistent: SQLite-DB und Config überleben Container-Neustarts
  • 📄 AniLoader.txt Import: Automatischer Import beim Container-Start
  • 💾 Export-Funktionen: Datenbank + Links als Download exportieren
  • 🔓 Anti-Sperre: DNS-over-HTTPS umgeht Provider-Blocks
  • ⚡ Autostart: Optional bei Container-Start Download-Modus starten
  • 📂 Separate Filmpfade: Anime-Filme und Serien-Filme in eigene Ordner (Separate-Modus)
  • 🐋 Docker-Ready: Multi-Arch Images (amd64/arm64) mit Health-Checks

Installation

Windows

# Repository klonen
git clone https://github.com/WimWamWom/AniLoader.git
cd AniLoader

# Virtual Environment
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

# Starten
python main.py

Voraussetzungen: Python 3.11+, ffmpeg im PATH

Linux

# Repository klonen  
git clone https://github.com/WimWamWom/AniLoader.git
cd AniLoader

# Dependencies + Virtual Environment
sudo apt install python3 python3-venv ffmpeg -y
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Starten
python main.py

Docker

# docker-compose.yml
services:
  aniloader:
    image: wimwamwom/aniloader:latest
    container_name: aniloader
    ports:
      - "5050:5050"
    volumes:
      - ./data:/app/data              # Config + DB
      - ./Downloads:/app/Downloads    # Standard-Modus  
      - ./Anime:/app/Anime           # Separate: aniworld.to
      - ./Serien:/app/Serien         # Separate: s.to
      - ./Anime-Filme:/app/Anime-Filme   # Separate: Anime-Filme
      - ./Serien-Filme:/app/Serien-Filme # Separate: Serien-Filme
    environment:
      - TZ=Europe/Berlin
    restart: unless-stopped
docker compose up -d

Unraid

Template: Community Apps → AniLoader
Docker Hub: wimwamwom/aniloader:latest

Port: 5050:5050
Volumes:

  • /mnt/user/appdata/aniloader → /app/data
  • /mnt/user/data/media/Downloads → /app/Downloads
  • /mnt/user/data/media/Anime → /app/Anime
  • /mnt/user/data/media/Serien → /app/Serien
  • /mnt/user/data/media/Anime-Filme → /app/Anime-Filme
  • /mnt/user/data/media/Serien-Filme → /app/Serien-Filme

WebUI: http://[IP]:5050

Verwendung

Web-Interface

URL: http://localhost:5050

📥 Download-Tab

  • Download-Modi starten/stoppen
  • Live-Status: Aktuelle Serie, Episode, Fortschritt
  • Echtzeit-Logs des laufenden Downloads

📂 Hinzufügen-Tab

  • URLs einzeln eingeben
  • TXT-Datei hochladen (Drag & Drop)
  • Suche mit Poster-Vorschau

🗃️ Datenbank-Tab

  • Alle Serien mit Status, Fortschritt, fehlendem DE-Content
  • Sortierung, Filter, Löschen/Wiederherstellen
  • 💾 Export DB: Komplette SQLite-Datenbank herunterladen
  • 📄 Export Links: Alle URLs als AniLoader.txt herunterladen

📜 Logs-Tab

  • Echtzeit-Logs mit Filter-Funktionen
  • Archivierte Logs nach Datum durchsuchen
  • Automatische Bereinigung nach konfigurierbaren Tagen

🤖 Automation-Tab

  • Cron-Schedules oder Intervall-basierte Läufe konfigurieren
  • Modi: german, new, german_new
  • Discord-Webhook für Benachrichtigungen pro Modus
  • Whitelist/Blacklist-Filter pro Modus
  • Lauf-Historie einsehen und Läufe manuell triggern

⚙️ Einstellungen-Tab

  • Speicherpfade (Standard/Separate Mode) mit Ordner-Browser
  • Separate Filmpfade für Anime-Filme und Serien-Filme
  • Sprachpriorität per Drag & Drop
  • Autostart, Titel-Refresh, System-Einstellungen

API

Base URL: http://localhost:5050
Swagger Docs: /docs

# Status abrufen
GET /status

# Download starten
POST /start_download
{"mode": "default"}  # default, german, new, check, german_new

# Download stoppen
POST /stop_download

# URL hinzufügen  
POST /add_link
{"url": "https://aniworld.to/anime/stream/naruto"}

# Suchen
POST /search  
{"query": "attack on titan", "platform": "both"}  # aniworld, sto, both

# Alle Serien
GET /database?q=naruto&sort=title&dir=asc

# Datenbank-Statistiken
GET /database/stats

# Serien-Eintrag aktualisieren / löschen / wiederherstellen
PUT    /anime/{id}
DELETE /anime/{id}?hard=false
POST   /anime/{id}/restore

# TXT-Datei importieren
POST /upload_txt

# Export-Funktionen
GET /export/database     # SQLite-DB Download
GET /export/links        # AniLoader.txt Download

# Titel aktualisieren (aus Webseiten)
POST /refresh_titles

# Konfiguration
GET  /config
POST /config

# Speicherplatz-Info
GET /disk

# Ordner-Browser (für Pfad-Auswahl)
POST /browse
{"path": "/app"}

# Poster-URL abrufen
GET /poster?url=https://aniworld.to/anime/stream/naruto

# Automation
GET  /automation/status
POST /automation/trigger/{mode}   # german | new | german_new
GET  /automation/history

Tampermonkey

  1. Tampermonkey Extension installieren
  2. Tampermonkey.user.js öffnen → Install
  3. Server-Adresse anpassen im Skript:
const SERVER_IP = "192.168.1.100";    // Deine AniLoader-IP
const SERVER_PORT = 5050;
  1. Fertig! Button erscheint auf aniworld.to/s.to Seiten

Button-Status:

  • 📤 Downloaden → Serie hinzufügen
  • 📄 In Liste → Wartet auf Download
  • ⬇️ Lädt... → Download aktiv
  • ✅ Komplett → Alle Episoden da

Konfiguration

Datei: data/config.yaml (wird automatisch erstellt)

server:
  port: 5050

languages:                    # Priorität: Erste verfügbare wird verwendet
  - German Dub               # 1. Priorität
  - German Sub               # 2. Priorität  
  - English Sub              # 3. Priorität
  - English Dub              # 4. Priorität

storage:
  mode: standard             # standard | separate
  download_path: /app/Downloads
  anime_path: /app/Anime               # Nur bei separate mode
  series_path: /app/Serien             # Nur bei separate mode
  anime_movies_path: /app/Anime-Filme  # Nur bei separate mode + anime_separate_movies: true
  serien_movies_path: /app/Serien-Filme # Nur bei separate mode + serien_separate_movies: true
  anime_separate_movies: false          # Anime-Filme in eigenen Ordner
  serien_separate_movies: false         # Serien-Filme in eigenen Ordner

download:
  autostart_mode: null       # null, default, german, new, check, german_new
  refresh_titles: false      # Titel beim Start von Webseiten aktualisieren
  min_free_gb: 2.0           # Mindest freier Speicher in GB
  timeout_seconds: 900       # Timeout pro Episode in Sekunden

logging:
  log_retention_days: 7      # Logs nach X Tagen automatisch löschen

Download-Modi:

  • default: Lädt alle unvollständigen Serien
  • german: Sucht fehlende deutsche Episoden
  • new: Prüft alle Serien auf neue Episoden
  • german_new: Kombiniert german + new in einem Lauf
  • check: Integritätsprüfung + defekte Downloads reparieren

Automation

Der Automation-Scheduler startet Download-Läufe automatisch nach einem Zeitplan.
Konfiguration über den Automation-Tab im Web-Interface oder direkt in data/config.yaml.

automation:
  enabled: true

  german:
    enabled: true
    schedule: "0 3 * * 0"   # Cron: jeden Sonntag um 3 Uhr
    interval_minutes: 0      # Alternativ: Intervall in Minuten (0 = cron verwenden)
    discord_webhook: ""      # Optional: Discord-Webhook URL
    notify_on_empty: false   # Benachrichtigen wenn keine neuen Episoden
    filter_mode: whitelist   # whitelist | blacklist
    whitelist: []            # Nur diese Serien prüfen (leer = alle)
    blacklist: []            # Diese Serien überspringen

  new:
    enabled: true
    schedule: "0 */6 * * *"  # Alle 6 Stunden
    interval_minutes: 0
    discord_webhook: ""
    notify_on_empty: false
    filter_mode: whitelist
    whitelist: []
    blacklist: []

  german_new:
    enabled: false
    schedule: ""
    interval_minutes: 0
    discord_webhook: ""
    notify_on_empty: false
    filter_mode: whitelist
    whitelist: []
    blacklist: []

Automation API:

GET  /automation/status              # Scheduler-Status + nächste Läufe
POST /automation/trigger/german      # Manuell starten
POST /automation/trigger/new
POST /automation/trigger/german_new
GET  /automation/history             # Lauf-Historie (letzte 20)

Datei-Struktur

Standard-Modus

Ein Ordner für alles (storage.mode: standard)

Downloads/
├── Naruto (2002) [imdbid-tt0409591]/
│   ├── Season 01/
│   │   ├── S01E001 - Erste Episode.mkv
│   │   ├── S01E002 - Zweite Episode [Sub].mkv    # German Sub
│   │   └── S01E003 - Episode 3 [English].mkv    # English Dub
│   ├── Season 02/
│   └── Filme/
│       └── Film01 - Naruto Movie.mkv
├── Breaking Bad (2008) [imdbid-tt0903747]/  
│   ├── Season 01/
│   └── Season 02/
└── Avatar (2009) [imdbid-tt0499549]/
    └── Filme/
        └── Film01 - Avatar.mkv

Separate-Modus

Getrennte Ordner (storage.mode: separate)

Anime/                        # aniworld.to Serien
├── Naruto (2002)/
│   ├── Season 01/
│   └── Season 02/ 
└── Attack on Titan (2013)/
    └── Season 01/

Anime-Filme/                  # aniworld.to Filme (anime_separate_movies: true)
└── Naruto Movie (2004)/
    └── Filme/

Serien/                       # s.to Serien  
├── Breaking Bad (2008)/
│   └── Season 01/
└── Game of Thrones (2011)/
    └── Season 01/

Serien-Filme/                 # s.to Filme (serien_separate_movies: true)
└── Some Movie (2010)/
    └── Filme/

Datei-Benennung:

  • Serien: S01E001 - Titel.mkv, S01E002 - Titel [Sub].mkv
  • Filme: Film01 - Titel.mkv, Film02 - Titel [Sub].mkv
  • Suffixe: "" (German Dub), [Sub] (German Sub), [English Dub], [English Sub]

FAQ

Q: Downloads funktionieren nicht / Timeouts
A: ffmpeg installiert? Python 3.11+? Genug Speicherplatz? Logs im Download-Tab prüfen

Q: "DNS-Fehler" oder Seiten nicht erreichbar
A: AniLoader nutzt DNS-over-HTTPS automatisch. Firewall für ausgehende HTTPS-Verbindungen prüfen

Q: Tampermonkey zeigt "Server offline"
A: Server-IP im Skript korrekt? AniLoader läuft? Browser-Konsole (F12) für Details prüfen

Q: Autostart beim Docker-Start aktivieren
A: config.yaml → autostart_mode: default oder in Web-UI Einstellungen ändern

Q: AniLoader.txt Import wie im alten AniLoader?
A: Links in AniLoader.txt (Hauptordner) → beim Start automatisch importiert + Datei geleert

Q: Datenbank/Links exportieren?
A: Datenbank-Tab → "💾 Export DB" (SQLite-Datei) oder "📄 Export Links" (AniLoader.txt)

Q: Separate vs Standard Mode?
A: Standard = Alles in Downloads. Separate = Anime/Serien getrennt für bessere Jellyfin-Organisation

Q: Welche Sprache wird heruntergeladen?
A: Erste verfügbare aus der languages-Liste. Kaskade: German Dub → German Sub → English Sub → English Dub

Q: Was ist der Unterschied zwischen german und german_new?
A: german sucht nur fehlende deutsche Episoden bei bereits vorhandenen Serien. german_new prüft zusätzlich auf neue Episoden – beides in einem Lauf.

Q: Wie richte ich Discord-Benachrichtigungen ein?
A: Im Automation-Tab pro Modus einen Discord-Webhook eintragen. AniLoader sendet eine Zusammenfassung nach jedem automatischen Lauf.

AniLoader
Made with ❤️ for Anime & Serien

About

AniLoader, ein Downloader für Aniworld, ist ein Python-Tool mit Web-Interface, das Animes und Serien automatisch in eine SQLite-Datenbank importiert, fehlende deutsche Folgen erkennt, Downloads startet, Dateien organisiert und alte nicht-deutsche Versionen löscht.

Topics

python windows linux docker automation downloader server web-ui sto serienstream aniworld aniworld-to serienstream-downloader aniworld-downloader

Resources

Readme
Activity

Stars

2 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages