HomeStream/README.md

95 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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)