xstreamDownloader/README.md

xStream Downloader

Web-basierter Downloader für Streaming-Seiten. Aus xStream (Kodi Addon) extrahiert und als eigenständiger Python-Server lauffähig gemacht.

Quick Start

cd xstreamDownloader
python3 app.py
# → http://localhost:8765

Features

• 18 Streaming-Sites: AnimeToast, AniWorld, BurningSeries, FilmPalast, HD Filme, KinoGer, KKiste, Megakino, NetzKino, SerienStream, Streamcloud, u.a.
• Web-Interface: Sidebar mit Sites, Grid-Ansicht für Filme/Serien, Hoster-Auswahl, Download-Liste
• Download-Manager: Parallele Downloads mit Fortschrittsanzeige
• Site-spezifische Cookies: AniWorld, FHDFilme, HDFilme

Architektur

xstreamDownloader/
├── app.py              # Flask-Server (API + Web-Interface, XBMC-konformer Wrapper)
├── web/index.html      # Single-Page Frontend (Vanilla JS)
├── xstream/
│   ├── sites/          # Site-Plugins (eines pro Streaming-Seite)
│   └── resources/lib/  # xStream Core (GUI, Player, Handler)
├── deps/               # Abhängigkeiten (resolveurl, requests, six, kodi_six, pyaes)
├── cookies/            # Session-Cookies für authentifizierte Sites
└── downloads/          # Heruntergeladene Dateien

API Endpoints

Endpoint	Beschreibung
GET /api/sites	Liste aller Sites
GET /api/sites/<id>/entries	Einträge einer Site
GET /api/sites/<id>/search?q=...	Suche auf einer Site
GET /api/sites/<id>/hosters?url=...	Hoster für einen Eintrag
GET /api/resolve?url=...	URL auflösen
POST /api/download?url=...&title=...	Download starten
GET /api/downloads	Download-Status
GET /api/downloads/<id>/file	Download-Datei herunterladen

Tech Stack

• Backend: Python 3, Flask, Multiprocessing
• Frontend: Vanilla JS, CSS Grid
• Scraping: xstream Core (aus Kodi Addon extrahiert)
• XBMC-Wrapper: Mock-Module für xbmc/xbmcgui/xbmcplugin/xbmcvfs/xbmcaddon