HomeStream/README.md

96 lines
2.7 KiB
Markdown
Raw Normal View History

2026-05-10 23:25:29 +02:00
# 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)