From 0dd018bbc6a2ef7c43a8a9946829a35285551fac Mon Sep 17 00:00:00 2001
From: Matthias Berner <matthiasberner@familie-berner.de>
Date: Mon, 6 Jul 2026 14:51:17 +0200
Subject: [PATCH] Add README.md

---
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1c2581c
--- /dev/null
+++ b/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)