Initial commit - HomeStream 0.1.0

README.md

@@ -0,0 +1,95 @@
+# HomeStream
+
+**DVB-C Streaming-Client für AVM FRITZ!Box-Router unter Windows.**
+
+Empfängt das TV- und Radio-Signal aus dem Kabelanschluss deiner FRITZ!Box per RTSP und zeigt es nativ am PC an. Inklusive EPG, Favoriten, Sender-Logos und RDS-Radiotext.
+
+Kostenlos und quelloffen.
+
+---
+
+## Features
+
+- 📺 **Live-TV** – alle SD- und HD-Sender deiner FRITZ!Box (HD bevorzugt, automatisch zusammengeführt)
+- 📻 **Radio** – mit Cover, Sendername und RDS-Radiotext (Künstler – Titel)
+- 🖼️ **Senderlogos** – automatisch geladen von AVM (TV + Radio)
+- 📅 **EPG** – Now/Next-Anzeige + scrollbares Joyn-Style-Programmraster aller Sender (8h)
+- ⭐ **Favoriten** – persistent gespeichert
+- 🔍 **Sender-Suche** – Live-Filter mit X-Button
+- ↔️ **Sidebar einklappbar** – beide Seitenleisten unabhängig (Strg+B togglet)
+- 🖥️ **Vollbild** – per Doppelklick oder F11
+- 🌙 **Dark Mode** – Titelleiste, Scrollbars, alles dunkel
+- 🔊 **Lautstärke und Sender werden gemerkt** – beim nächsten Start
+
+---
+
+## Voraussetzungen
+
+- Windows 10 / 11
+- AVM FRITZ!Box mit aktivem DVB-C-Empfang (Kabel-Tuner)
+- Erreichbar im LAN (Standard-IP `192.168.178.1`, einstellbar)
+
+---
+
+## Installation
+
+### 1. Release herunterladen
+
+Aktuelles Release von [dimedtec.net/dimedtec/HomeStream](https://www.dimedtec.net/dimedtec/HomeStream/releases) als ZIP herunterladen.
+
+### 2. Entpacken
+
+Inhalt in einen beliebigen Ordner entpacken, z.B.:
+```
+C:\Programme\HomeStream\
+```
+
+### 3. Starten
+
+`HomeStream.exe` doppelklicken. Beim ersten Start unter **⚙ Einstellungen** die FritzBox-IP eintragen.
+
+---
+
+## Hotkeys
+
+| Taste | Funktion |
+|---|---|
+| **F11** oder **Doppelklick** | Vollbild umschalten |
+| **Esc** | Vollbild verlassen / EPG schließen |
+| **Strg+B** | Sidebar + Senderliste umschalten |
+| **↑ / ↓** | Sender vor/zurück |
+| **M** | Stumm |
+
+---
+
+## Daten
+
+HomeStream speichert lokal unter `%APPDATA%\HomeStream\`:
+- `settings.json` – FritzBox-IP, Favoriten, letzter Sender, Lautstärke
+- `logos\` – Sender-Logos (von tv.avm.de und download.avm.de)
+- `epg\` – EPG-Cache (24 h)
+- `crash.log` – falls die App abstürzt
+
+---
+
+## Build aus dem Source
+
+```powershell
+git clone https://www.dimedtec.net/dimedtec/HomeStream.git
+cd HomeStream
+dotnet publish -c Release -r win-x64 --self-contained -p:PublishSingleFile=true
+```
+
+Die Versionsnummer kommt automatisch aus dem aktuellen Git-Tag (`git describe --tags`).
+
+---
+
+## Hinweis
+
+HomeStream verwendet [libVLC](https://www.videolan.org/vlc/libvlc.html) (LGPL) und Daten von `tv.avm.de` und `epg.pw`. Die Software ist nicht mit AVM GmbH verbunden oder von dieser unterstützt; "FRITZ!" und "FRITZ!Box" sind eingetragene Marken der AVM GmbH.
+
+---
+
+## Lizenz
+
+MIT – siehe [LICENSE](LICENSE)