Add README.md

README.md

@@ -0,0 +1,47 @@
+# 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
+
+```bash
+cd xstreamDownloader
+python3 mini_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/
+├── mini_app.py          # Flask-Server (API + Web-Interface)
+├── web/index.html       # Single-Page Frontend (Vanilla JS)
+├── xstream/
+│   ├── sites/           # Site-Plugins (eines pro Streaming-Seite)
+│   └── resources/lib/   # xStream Core (GUI, Player, Handler)
+├── cookies/             # Session-Cookies für authentifizierte Sites
+└── resources/           # Kodi settings.xml
+```
+
+## API Endpoints
+
+| Endpoint | Beschreibung |
+|----------|--------------|
+| `GET /api/sites` | Liste aller Sites |
+| `GET /api/sites/<id>/entries` | Einträge einer Site |
+| `GET /api/sites/<id>/hoster/<entry_id>` | Hoster für einen Eintrag |
+| `POST /api/download` | Download starten |
+| `GET /api/downloads` | Download-Status |
+
+## Tech Stack
+
+- **Backend**: Python 3, Flask
+- **Frontend**: Vanilla JS, CSS Grid
+- **Scraping**: xbmcjson/xStream Core (aus Kodi Addon extrahiert)