HomeStream/_wiki_home.md

292 lines
10 KiB
Markdown
Raw Normal View History

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