From ce95ed27d82f5a6fac9b120776249bc1f3c95f46 Mon Sep 17 00:00:00 2001 From: dimedtec Date: Thu, 11 Jun 2026 12:26:08 +0200 Subject: [PATCH] Wiki: Benutzerhandbuch --- Home.md | 292 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 291 insertions(+), 1 deletion(-) diff --git a/Home.md b/Home.md index ea78fbf..75ec965 100644 --- a/Home.md +++ b/Home.md @@ -1 +1,291 @@ -Willkommen im Wiki. \ No newline at end of file +# 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)*