# HomeStream – Benutzerhandbuch

HomeStream ist ein DVB-C Streaming-Client für Windows, der AVM FRITZ!Box-Router als Quelle nutzt und zusätzlich öffentlich-rechtliche Online-Streams sowie Streaming-Dienste (YouTube, Netflix, Mediatheken) integriert.

---

## Inhaltsverzeichnis

1. [Systemvoraussetzungen](#1-systemvoraussetzungen)
2. [Installation](#2-installation)
3. [Erster Start](#3-erster-start)
4. [Oberfläche](#4-oberfläche)
5. [Sender & Kategorien](#5-sender--kategorien)
6. [Wiedergabe & Steuerung](#6-wiedergabe--steuerung)
7. [Favoriten](#7-favoriten)
8. [EPG – Programmführer](#8-epg--programmführer)
9. [Erinnerungen](#9-erinnerungen)
10. [Streaming-Browser](#10-streaming-browser)
11. [Einstellungen](#11-einstellungen)
12. [Tastenkürzel](#12-tastenkürzel)
13. [Häufige Probleme](#13-häufige-probleme)

---

## 1. Systemvoraussetzungen

| Anforderung | Details |
|---|---|
| Betriebssystem | Windows 10 oder Windows 11 (64-Bit) |
| .NET-Runtime | Nicht erforderlich – selbst-enthaltener Build |
| FRITZ!Box | DVB-C muss aktiviert und konfiguriert sein |
| Netzwerk | App und FRITZ!Box im gleichen Heimnetzwerk |
| WebView2 Runtime | Für Streaming-Browser (auf Win10/11 meist vorinstalliert) |

---

## 2. Installation

1. Neueste Version von der [Release-Seite](https://www.dimedtec.net/dimedtec/HomeStream/releases) herunterladen
2. ZIP-Datei entpacken (z.B. nach `C:\Programme\HomeStream\`)
3. `HomeStream.exe` starten – keine Installation erforderlich

> **Hinweis:** Windows SmartScreen kann beim ersten Start eine Warnung anzeigen. „Weitere Informationen" → „Trotzdem ausführen" wählen.

---

## 3. Erster Start

Beim ersten Start lädt HomeStream automatisch:
- Die Senderliste von der FRITZ!Box (`192.168.178.1` ist der Standard)
- Online-Sender (ÖR-TV und Webradio) aus der integrierten Quellenliste
- EPG-Daten von iptv-epg.org (~6 MB, einmalig pro Tag)

Falls die FRITZ!Box-Adresse abweicht, unter **Einstellungen** die korrekte IP eintragen.

---

## 4. Oberfläche

```
┌─────────────┬──────────────────────┬────────────────────────────────┐
│  Kategorien │    Senderliste       │         Videobild              │
│  (Sidebar)  │                      │                                │
│             │  ▶ Das Erste HD      │                                │
│ 📺 TV Fritz │    ZDF HD            │                                │
│ 📺 TV Online│    3sat HD           │                                │
│ 📡 Radio    │    ...               │                                │
│ 🌐 Streaming│                      │                                │
│ ⭐ Favoriten│                      │                                │
│ 📅 Programm │                      │                                │
├─────────────┴──────────────────────┴────────────────────────────────┤
│  Das Erste HD  ● FritzBox   ▶ Jetzt: Tagesschau                    │
│  🔊 ──────────────  📌  ⛶                                          │
└─────────────────────────────────────────────────────────────────────┘
```

**Bereiche:**
- **Linke Spalte:** Kategorie-Buttons zur Filterung
- **Mittlere Spalte:** Senderliste mit Suchfeld oben
- **Hauptbereich:** Videobild / Streaming-Browser
- **Untere Leiste:** Aktueller Sender, EPG-Info, Lautstärke, Buttons

---

## 5. Sender & Kategorien

### Kategorien

| Kategorie | Inhalt |
|---|---|
| 📺 TV (FritzBox) | DVB-C Fernsehen über die FRITZ!Box |
| 📺 TV (Online) | Öffentlich-rechtliche TV-Streams (ARD, ZDF, 3sat, ARTE …) |
| 📡 Radio (FritzBox) | DVB-C Radiosender über die FRITZ!Box |
| 📡 Radio (Online) | Webradio (Bayern, DLF, WDR, NDR, SWR …) |
| 🌐 Streaming | Browser-basierte Streaming-Dienste |
| ⭐ Favoriten | Alle als Favorit markierten Sender |

> Die App startet immer mit der **Favoriten**-Ansicht.

### Sendersuche

Im Suchfeld oben in der Senderliste tippen – die Liste filtert in Echtzeit.

### Sidebar ein-/ausblenden

**Strg+B** blendet die beiden linken Spalten ein oder aus. Wenn ausgeblendet, erscheint ein Hinweis in der Titelleiste.

---

## 6. Wiedergabe & Steuerung

### Sender wechseln

Sender in der Liste anklicken – nach einer kurzen Verzögerung (250 ms Debounce) startet die Wiedergabe.

### Lautstärke

- Schieberegler in der Statusleiste unten
- **🔊-Button** für Stummschalten (Toggle)
- Tastenkürzel: **M** für Stummschalten

### Vollbild

- **F11** oder Doppelklick auf das Video
- **ESC** beendet den Vollbildmodus

### Immer im Vordergrund

- **📌-Button** (Pin) in der Statusleiste
- Oder **Strg+T**
- Aktiv: Button leuchtet blau

---

## 7. Favoriten

- **⭐-Button** in der Statusleiste neben dem Sendernamen klicken
- Favorit ist gesetzt wenn der Stern gefüllt ist (★)
- Favoriten sind **medienübergreifend** – FritzBox-, Online- und Streaming-Sender können gleichermaßen als Favorit gespeichert werden
- Favoriten werden in `%APPDATA%\HomeStream\settings.json` gespeichert

---

## 8. EPG – Programmführer

### Aktuelles Programm

Unter dem Sendernamen in der Statusleiste wird angezeigt:
- **▶ Jetzt:** Aktuelle Sendung (FritzBox: aus EIT-Signal; Online: aus EPG-Daten)
- Danach: Die nächsten 2–3 Sendungen mit Uhrzeit

Diese Anzeige aktualisiert sich automatisch alle 60 Sekunden.

### Programmübersicht (Grid)

Klick auf **📅 Programm** in der Sidebar öffnet ein Joyn-ähnliches EPG-Grid:

- Alle TV-Sender in einer Übersicht
- 8 Stunden Programmvorschau
- Aktuelle Sendung rot hervorgehoben
- **Linksklick** auf eine Sendung: sofort einschalten
- **Rechtsklick** auf eine Sendung: Erinnerung setzen
- Tooltip zeigt Titel, Uhrzeit und Beschreibung

**Navigation im Grid:**
- Horizontales Scrollen: Mausrad oder Scrollbar
- Vertikales Scrollen: Mausrad oder Scrollbar

> EPG-Daten werden täglich frisch von [iptv-epg.org](https://iptv-epg.org) geladen und lokal in `%APPDATA%\HomeStream\epg\` gecacht.

---

## 9. Erinnerungen

Im EPG-Grid eine zukünftige Sendung **rechts klicken** → „⏰ 5 min vorher erinnern".

- Die Sendung zeigt ein ⏰-Symbol im Grid
- 5 Minuten vor Sendungsstart erscheint eine Benachrichtigung
- Auf **„Ja"** klicken schaltet automatisch auf den Sender um und schließt das EPG
- Erinnerungen werden in `%APPDATA%\HomeStream\reminders.json` gespeichert und überleben App-Neustarts

Zum Entfernen: Rechtsklick auf die Sendung → „⏰ Erinnerung entfernen".

---

## 10. Streaming-Browser

Unter **🌐 Streaming** sind Browser-basierte Dienste verfügbar:

| Dienst | URL |
|---|---|
| YouTube | youtube.com |
| ARD Mediathek | ardmediathek.de |
| ZDF Mediathek | zdf.de |
| Netflix | netflix.com |
| Disney+ | disneyplus.com |
| Joyn | joyn.de |
| RTL+ | plus.rtl.de |
| ARTE | arte.tv/de |
| Apple TV+ | tv.apple.com |
| Amazon Prime Video | amazon.de/gp/video |
| n-tv | n-tv.de |

### Login speichern

Der Streaming-Browser verwendet ein **persistentes WebView2-Profil** unter `%APPDATA%\HomeStream\webview2\`. Einmal einloggen genügt – der Login bleibt beim nächsten App-Start erhalten.

### Steuerung im Browser-Modus

- Normale Browser-Navigation per Maus
- **Strg+B** öffnet die Sidebar wieder wenn sie eingeklappt ist
- **🔊-Button** (Stummschalten) funktioniert auch im Browser-Modus
- **📌-Button** (Immer im Vordergrund) funktioniert auch im Browser-Modus

### Wechsel zurück zu TV

Einfach einen TV- oder Radio-Sender in der Senderliste anklicken – der Browser wird automatisch gestoppt und der VLC-Player übernimmt.

---

## 11. Einstellungen

Erreichbar über den **⚙-Button** in der Statusleiste.

| Einstellung | Beschreibung |
|---|---|
| FritzBox-Adresse | IP oder Hostname der FRITZ!Box (Standard: 192.168.178.1) |
| Online-Sender anzeigen | ÖR-TV und Webradio ein-/ausschalten |

---

## 12. Tastenkürzel

| Taste | Funktion |
|---|---|
| **Strg+B** | Sidebar ein-/ausblenden |
| **Strg+T** | Immer im Vordergrund an/aus |
| **F11** | Vollbild an/aus |
| **ESC** | Vollbild beenden / EPG schließen |
| **M** | Stummschalten |
| **↑ / ↓** | Sender in der Liste wechseln |

---

## 13. Häufige Probleme

### Senderliste leer / FRITZ!Box nicht erreichbar

- FRITZ!Box-Adresse in den Einstellungen prüfen
- DVB-C in der FRITZ!Box aktiviert? → FRITZ!Box-Oberfläche → Heimnetz → Multimedia → DVB-C
- App und FRITZ!Box im gleichen Netzwerk?
- Online-Sender funktionieren auch ohne FRITZ!Box

### Bild friert ein / ruckelt

- FRITZ!Box neu starten
- Prüfen ob ein anderes Gerät gleichzeitig streamt (FRITZ!Box erlaubt nur einen Stream pro IP-Adresse)
- Im originalen VLC-Player testen: wenn dort auch Probleme auftreten, liegt es am DVB-Signal

### EPG zeigt falsche Zeiten oder keine Daten

- EPG-Cache löschen: `%APPDATA%\HomeStream\epg\` leeren
- App neu starten – EPG wird automatisch neu geladen

### Streaming-Browser startet nicht / WebView2 fehlt

- WebView2 Runtime installieren: [Microsoft WebView2 Runtime](https://developer.microsoft.com/de-de/microsoft-edge/webview2/)
- Auf Windows 10 Version 1803 oder neuer aktualisieren

### Login im Streaming-Browser geht verloren

- Das WebView2-Profil liegt in `%APPDATA%\HomeStream\webview2\`
- Wird dieser Ordner gelöscht, gehen alle gespeicherten Logins verloren

---

## Datenspeicherung

Alle Benutzerdaten werden lokal gespeichert unter `%APPDATA%\HomeStream\`:

| Datei/Ordner | Inhalt |
|---|---|
| `settings.json` | Einstellungen, Favoriten, letzter Sender |
| `reminders.json` | Gespeicherte EPG-Erinnerungen |
| `epg\` | Gecachte EPG-Daten (täglich aktualisiert) |
| `logos\` | Gecachte Sender-Logos |
| `webview2\` | Browser-Profil (Logins, Cookies) |

---

*HomeStream wird entwickelt von [dimedtec GmbH](https://www.dimedtec.net) · [Quellcode & Releases](https://www.dimedtec.net/dimedtec/HomeStream)*