HomeStream/_wiki_home.md

291 lines
10 KiB
Markdown
Raw 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 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)*