diff --git a/README.md b/README.md index e20ee89..a0ad8c9 100644 --- a/README.md +++ b/README.md @@ -1,153 +1,193 @@ -
-
-
Live-TV, Filme, Serien, Multi-View und Aufnahmen für Windows.
- - - -- Download · - Funktionen · - Beispielbilder · - Erste Schritte · - Changelog 1.1.9 -
- - - -Simple TV spielt eigene **M3U-Dateien, M3U-Links und Xtream-Codes-Zugänge** ab. Live-TV, Programmübersicht, Mediathek, Downloads und Aufnahmen sind in einer Windows-Oberfläche zusammengefasst. Mehrere Playlists, persönliche Favoriten und Wiedergabestände bleiben gespeichert. - -## Download - -**[Aktuelle Version für Windows herunterladen](https://git.24-music.de/Administrator/simple-tv-releases/releases/latest)** - -| Datei | Verwendung | -| --- | --- | -| `SimpleTV-win-Setup.exe` | Installation mit Desktop- und Startmenü-Verknüpfung | -| `SimpleTV-win-Portable.zip` | Entpacken und ohne Installer starten | -| `SHA256SUMS.txt` | SHA-256-Prüfsummen der veröffentlichten Dateien | -| `SimpleTV-…-full.nupkg` und Update-Metadaten | Automatische Aktualisierung; nicht manuell entpacken | - -.NET, VLC und die Aufnahme-Werkzeuge werden mitgeliefert. Der Installer ist derzeit nicht Authenticode-signiert. Für den Download und die integrierte Updateprüfung ist kein Forgejo-Konto erforderlich. - -**Neu in 1.1.9:** Überarbeitete Playlist-Verwaltung mit Quellenwechsel, Entwürfen und stabiler Prüfung, aktuelle Playlist-Namen im Verlauf sowie verbesserte Senderlisten- und Player-Übergänge. Das [vollständige Changelog](https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v1.1.9) beschreibt alle Änderungen seit 1.1.8. - -## Funktionen - -### Live-TV und Playlists - -- Mehrere gespeicherte Playlists mit Suche, Länderfiltern, Senderlogos und Qualitätsvarianten. -- Aufklappbare Kategorien mit eigenen Namen, anpinnbare Gruppen und gespeicherte Reihenfolge. -- Favoriten mit goldenen Sternen, eigene Favoritengruppen, Mehrfachauswahl und nach Tagen gegliederter Verlauf. -- Hintergrundimport und virtuelle Senderlisten für große Kataloge. -- Playlist Manager zum Hinzufügen, Bearbeiten und Aktualisieren von Quellen. -- Getrennte TV- und Filmsitzungen: TV kann beim Filmstart stumm weiterlaufen, soweit die verfügbaren Verbindungen ausreichen. - -### Mediathek und Fortsetzen - -- Startseite mit Fortsetzen, beliebten Filmen/Serien und Neuerscheinungen. -- Entdecken mit Genre- und Sprachfiltern, vollständigen Rasterreihen und Nachladekarten. -- Empfehlungen werden mit dem eigenen Playlist-Angebot abgeglichen. -- Detailansichten mit Covern, Titellogos, Hintergrundbildern, Bewertungen und Folgenauswahl. -- Merkliste, Gesehen-/Ungesehen-Status und Fortschritt für Filme, Serien und lokale Downloads. -- Nächste ungesehene Folge direkt in Fortsetzen; Titel bei Bedarf aus der Reihe entfernen. -- Dauerhafter Detail-/Laufzeit-Cache und begrenztes Vorladen sichtbarer Filme. -- Bereits geladene Mediatheken werden beim Wechsel zwischen Playlists wiederverwendet. - -### Player und Multi-View - -- Bis zu vier Live-Streams mit eigener Steuerung, Tonquelle und Aufnahmefunktion. -- Einzelstream-Vollbild sowie gemeinsames Vollbild, Kinomodus, Miniplayer und Pop-out. -- Ziehbares Pop-out mit Größenänderung und optional „Immer im Vordergrund“. -- Wiedergabegeschwindigkeit von 0,25× bis 4×, Zeitleiste und Vor-/Rücksprünge. -- Tonspurwahl, eingebettete Untertitel, lokale Untertiteldateien und anpassbare Untertiteldarstellung. -- Lautstärkeregler, Prozentfeld und Mausradsteuerung; optionale zusätzliche Verstärkung. -- Bevorzugte Sprachen, automatische nächste Folge und Einschlaftimer. -- Native Audioübergänge erhalten vorhandene Puffer; Verfügbarkeit und Format der Quelle bestimmen weiterhin das Verhalten. - -### Programmübersicht und Aufnahmen - -- EPG aus XMLTV/XMLTV.gz mit farbigen Sendungskarten, Logozeilen, Suche und Zeitnavigation. -- Manuelle Senderzuordnung und ergänzende deutsche Programmdaten. -- Direktaufnahmen, geplante Aufnahmen und Erinnerungen. -- Hintergrundrecorder mit Windows-Aufweckplanung und Schutz vor automatischem Einschlafen während Aufnahme und Export. -- Eigener Aufnahmen-Tab mit großer Fokus-Vorschau, Coverkarten, Senderlogos, Dateiübersicht, Suche und Statusfiltern. -- Fehlgeschlagene und abgebrochene Einträge in eigener Gruppe; Aufnahmen direkt abspielen, umbenennen und mit Bestätigung löschen. -- MP4-Export im Hintergrund, datierte Aufnahmeordner und Dateiabgleich. -- Lokales Timeshift zum Pausieren und Zurückspringen im verfügbaren Puffer. - -### Downloads und Warteschlange - -- Filme und einzelne Folgen direkt aus der Mediathek herunterladen. -- Warteschlangen-Dropdown mit Status sowie eigener Downloads-Tab. -- Grüner Fortschritt, Dateigröße, Geschwindigkeit und geschätzte Restzeit. -- Pause/Fortsetzen und Wiederaufnahme nach Neustart, sofern die Quelle Teilabfragen unterstützt. -- Vorhandene Teildateien bleiben bei ungeeigneten Range-Antworten erhalten. -- Fertige Downloads abspielen und mit derselben Fortsetzen-Liste weiterschauen. - -### Darstellung, Daten und Updates - -- Dark- und Light-Theme, anpassbare Covergrößen und skalierbare Bedienelemente. -- Lokal verschlüsselte Playlist-Zugänge, Bibliothek und Wiedergabestände. -- Passwortverschlüsselte Sicherung und Wiederherstellung. -- Updateprüfung beim Start und regelmäßig im Hintergrund. -- Der Update-Dialog zeigt beim Start alle veröffentlichten Änderungen zwischen installierter und angebotener Version. „Update verfügbar“ links neben „Einstellungen“ öffnet ihn erneut. -- „Jetzt installieren“ lädt und prüft das Paket, schließt die App nach dem Speichern und startet sie aktualisiert neu. „Abbrechen“ installiert nichts; auch zwischengespeicherte Updates benötigen eine ausdrückliche Installation. - -## Beispielbilder - -Die Bilder zeigen die tatsächliche Oberfläche mit **isolierten Beispieldaten**. Öffentliche Poster und Logos veranschaulichen die Mediathek; sie sind kein enthaltenes Film-, Serien- oder Senderangebot. Es werden keine privaten Playlist-Adressen oder Zugangsdaten gezeigt. - -### Entdecken und Titeldetails - - - -### Programmübersicht - - - -## Erste Schritte - -1. Setup installieren oder die Portable-ZIP entpacken und `Simple TV.exe` öffnen. -2. Über **Playlist verwalten** eine M3U-Datei, einen M3U-Link oder einen Xtream-Zugang hinzufügen. -3. In **Live-TV** einen Sender auswählen. Für Programmdaten bei Bedarf eine EPG-Quelle zuweisen. -4. Bei einem Xtream-Angebot **Mediathek** öffnen und Filme oder Serien auswählen. -5. Unter **Einstellungen** Downloadordner, Darstellung, bevorzugte Sprachen und Wiedergabeoptionen festlegen. - -| Bedienung | Aktion | -| --- | --- | -| F11 / Esc | Vollbild umschalten / verlassen | -| Leertaste im Player | Pausieren / fortsetzen | -| Mausrad über dem Video | Lautstärke ändern | -| Doppelklick auf das Video | Vollbild; im Miniplayer zur großen Wiedergabe | -| Drei Punkte am Cover | Sehstatus, Fortsetzen und Datei speichern | -| Rechtsklick auf eine Kategorie | Umbenennen, Anpinnen, Favoriten und Reihenfolge verwalten | - -## Voraussetzungen und Grenzen - -- Windows x64 und eine eigene unterstützte Quelle. Senderlisten und Anbieterzugänge werden nicht mitgeliefert. -- Gleichzeitige Streams und Aufnahmen benötigen ausreichend erlaubte Anbieter-Verbindungen. -- Geplante Aufnahmen laufen in einem separaten Hintergrundprozess bei geschlossenem Fenster. Windows-Aufweck-Timer setzen unterstützte Hardware, passende Energierichtlinien und einen angemeldeten Benutzer voraus. -- Erinnerungen und manuelle Direktaufnahmen benötigen die geöffnete App. Vollständiges Herunterfahren verhindert lokale Aufnahmen. -- Verfügbare Sprachen in der Mediathek bezeichnen Playlist-Versionen; sie sind keine vollständige Prüfung eingebetteter Tonspuren. -- **Anbieter-Catch-up ist derzeit deaktiviert.** Lokales Timeshift und Live-Aufnahmen bleiben verfügbar. -- DRM, HLS-Downloads und direkte OpenSubtitles-Suche sind nicht enthalten. -- Metadaten, Bildmaterial, Laufzeiten und Programmabdeckung hängen von den jeweiligen Quellen ab. - -## Speicherung - -Die installierte App speichert ihre verschlüsselten Daten unter `%LOCALAPPDATA%\Fluss IPTV`. Der interne Ordnername bleibt aus Kompatibilitätsgründen bestehen. Heruntergeladene Videos und Aufnahmen liegen im eingestellten Zielordner. - -Die Sicherung unter Einstellungen kann persönliche Zustände und optional Playlist-Zugänge exportieren. Videodateien werden dabei nicht mitgesichert. - -## Verteilung und Lizenzen - -Dieses Repository enthält ausschließlich Dokumentation, Beispielbilder und fertige Programmpakete. Der Quellcode bleibt privat. Lizenztexte und Quellcodeverweise der mitgelieferten Bibliotheken befinden sich im installierten Programmordner. +
+
+
Live-TV, Filme, Serien, Multi-View und Aufnahmen für Windows.
+ + + ++ Download · + Funktionen · + Beispielbilder · + Erste Schritte · + Changelog 1.1.10 +
+ + + +Simple TV spielt eigene **M3U-Dateien, M3U-Links und Xtream-Codes-Zugänge** ab. Live-TV, Programmübersicht, Mediathek, Downloads und Aufnahmen sind in einer Windows-Oberfläche zusammengefasst. Mehrere Playlists, persönliche Favoriten und Wiedergabestände bleiben gespeichert. + +## Download + +**[Aktuelle Version für Windows herunterladen](https://git.24-music.de/Administrator/simple-tv-releases/releases/latest)** + +| Datei | Verwendung | +| --- | --- | +| `SimpleTV-win-Setup.exe` | Installation mit Desktop- und Startmenü-Verknüpfung | +| `SimpleTV-win-Portable.zip` | Entpacken und ohne Installer starten | +| `SHA256SUMS.txt` | SHA-256-Prüfsummen der veröffentlichten Dateien | +| `SimpleTV-…-full.nupkg` und Update-Metadaten | Automatische Aktualisierung; nicht manuell entpacken | + +.NET, VLC und die Aufnahme-Werkzeuge werden mitgeliefert. Der Installer ist derzeit nicht Authenticode-signiert. Für den Download und die integrierte Updateprüfung ist kein Forgejo-Konto erforderlich. + +**Neu in 1.1.10:** Weiches Einblenden neuer Playlist-Entwürfe und schnellerer Entwicklungsstart mit Hot Reload im Hintergrund. Das [vollständige Changelog](https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v1.1.10) beschreibt alle Änderungen seit 1.1.9. + +## Funktionen + +### Live-TV und Playlists + +- Mehrere gespeicherte Playlists mit Suche, Länderfiltern, Senderlogos und Qualitätsvarianten. +- Aufklappbare Kategorien mit eigenen Namen, anpinnbare Gruppen und gespeicherte Reihenfolge. +- Favoriten mit goldenen Sternen, eigene Favoritengruppen, Mehrfachauswahl und nach Tagen gegliederter Verlauf. +- Hintergrundimport und virtuelle Senderlisten für große Kataloge. +- Playlist Manager zum Hinzufügen, Bearbeiten und Aktualisieren von Quellen. +- Getrennte TV- und Filmsitzungen: TV kann beim Filmstart stumm weiterlaufen, soweit die verfügbaren Verbindungen ausreichen. + +### Mediathek und Fortsetzen + +- Startseite mit Fortsetzen, beliebten Filmen/Serien und Neuerscheinungen. +- Entdecken mit Genre- und Sprachfiltern, vollständigen Rasterreihen und Nachladekarten. +- Empfehlungen werden mit dem eigenen Playlist-Angebot abgeglichen. +- Detailansichten mit Covern, Titellogos, Hintergrundbildern, Bewertungen und Folgenauswahl. +- Merkliste, Gesehen-/Ungesehen-Status und Fortschritt für Filme, Serien und lokale Downloads. +- Nächste ungesehene Folge direkt in Fortsetzen; Titel bei Bedarf aus der Reihe entfernen. +- Dauerhafter Detail-/Laufzeit-Cache und begrenztes Vorladen sichtbarer Filme. +- Bereits geladene Mediatheken werden beim Wechsel zwischen Playlists wiederverwendet. + +### Player und Multi-View + +- Bis zu vier Live-Streams mit eigener Steuerung, Tonquelle und Aufnahmefunktion. +- Einzelstream-Vollbild sowie gemeinsames Vollbild, Kinomodus, Miniplayer und Pop-out. +- Ziehbares Pop-out mit Größenänderung und optional „Immer im Vordergrund“. +- Wiedergabegeschwindigkeit von 0,25× bis 4×, Zeitleiste und Vor-/Rücksprünge. +- Tonspurwahl, eingebettete Untertitel, lokale Untertiteldateien und anpassbare Untertiteldarstellung. +- Lautstärkeregler, Prozentfeld und Mausradsteuerung; optionale zusätzliche Verstärkung. +- Bevorzugte Sprachen, automatische nächste Folge und Einschlaftimer. +- Native Audioübergänge erhalten vorhandene Puffer; Verfügbarkeit und Format der Quelle bestimmen weiterhin das Verhalten. + +### Programmübersicht und Aufnahmen + +- EPG aus XMLTV/XMLTV.gz mit farbigen Sendungskarten, Logozeilen, Suche und Zeitnavigation. +- Manuelle Senderzuordnung und ergänzende deutsche Programmdaten. +- Direktaufnahmen, geplante Aufnahmen und Erinnerungen. +- Hintergrundrecorder mit zeitgesteuertem Windows-Aufwecken und Schutz vor automatischem Einschlafen während Aufnahme und Export. +- Eigener Aufnahmen-Tab mit großer Fokus-Vorschau, Coverkarten, Senderlogos, Dateiübersicht, Suche und Statusfiltern. +- Fehlgeschlagene und abgebrochene Einträge in eigener Gruppe; Aufnahmen direkt abspielen, umbenennen und mit Bestätigung löschen. +- MP4-Export im Hintergrund, datierte Aufnahmeordner und Dateiabgleich. +- Lokales Timeshift zum Pausieren und Zurückspringen im verfügbaren Puffer. + +### Downloads und Warteschlange + +- Filme und einzelne Folgen direkt aus der Mediathek herunterladen. +- Warteschlangen-Dropdown mit Status sowie eigener Downloads-Tab. +- Grüner Fortschritt, Dateigröße, Geschwindigkeit und geschätzte Restzeit. +- Pause/Fortsetzen und Wiederaufnahme nach Neustart, sofern die Quelle Teilabfragen unterstützt. +- Vorhandene Teildateien bleiben bei ungeeigneten Range-Antworten erhalten. +- Fertige Downloads abspielen und mit derselben Fortsetzen-Liste weiterschauen. + +### Darstellung, Daten und Updates + +- Dark- und Light-Theme, anpassbare Covergrößen und skalierbare Bedienelemente. +- Lokal verschlüsselte Playlist-Zugänge, Bibliothek und Wiedergabestände. +- Passwortverschlüsselte Sicherung und Wiederherstellung. +- Updateprüfung beim Start und regelmäßig im Hintergrund. +- Der Update-Dialog zeigt beim Start alle veröffentlichten Änderungen zwischen installierter und angebotener Version. „Update verfügbar“ links neben „Einstellungen“ öffnet ihn erneut. +- „Jetzt installieren“ lädt und prüft das Paket, schließt die App nach dem Speichern und startet sie aktualisiert neu. „Abbrechen“ installiert nichts; auch zwischengespeicherte Updates benötigen eine ausdrückliche Installation. + +## Beispielbilder + +Die Bilder zeigen die tatsächliche Oberfläche mit **isolierten Beispieldaten**. Öffentliche Poster und Logos veranschaulichen die Mediathek; sie sind kein enthaltenes Film-, Serien- oder Senderangebot. Es werden keine privaten Playlist-Adressen oder Zugangsdaten gezeigt. + +### Entdecken und Titeldetails + + + +### Programmübersicht + + + +## Erste Schritte + +1. Setup installieren oder die Portable-ZIP entpacken und `Simple TV.exe` öffnen. +2. Über **Playlist verwalten** eine M3U-Datei, einen M3U-Link oder einen Xtream-Zugang hinzufügen. +3. In **Live-TV** einen Sender auswählen. Für Programmdaten bei Bedarf eine EPG-Quelle zuweisen. +4. Bei einem Xtream-Angebot **Mediathek** öffnen und Filme oder Serien auswählen. +5. Unter **Einstellungen** Downloadordner, Darstellung, bevorzugte Sprachen und Wiedergabeoptionen festlegen. + +| Bedienung | Aktion | +| --- | --- | +| F11 / Esc | Vollbild umschalten / verlassen | +| Leertaste im Player | Pausieren / fortsetzen | +| Mausrad über dem Video | Lautstärke ändern | +| Doppelklick auf das Video | Vollbild; im Miniplayer zur großen Wiedergabe | +| Drei Punkte am Cover | Sehstatus, Fortsetzen und Datei speichern | +| Rechtsklick auf eine Kategorie | Umbenennen, Anpinnen, Favoriten und Reihenfolge verwalten | + +## Voraussetzungen und Grenzen + +- Windows x64 und eine eigene unterstützte Quelle. Senderlisten und Anbieterzugänge werden nicht mitgeliefert. +- Gleichzeitige Streams und Aufnahmen benötigen ausreichend erlaubte Anbieter-Verbindungen. +- Geplante Aufnahmen laufen in einem separaten Hintergrundprozess, auch wenn das Fenster geschlossen ist. Windows-Aufgaben wecken den Rechner aus unterstütztem Standby/Ruhezustand; der Windows-Benutzer muss angemeldet bleiben. +- Erinnerungen und manuelle Direktaufnahmen bleiben an die laufende App gebunden. Ein vollständig heruntergefahrener oder stromloser Rechner kann nicht durch den Aufnahmetimer gestartet werden. +- Verfügbare Sprachen in der Mediathek bezeichnen Playlist-Versionen; sie sind keine vollständige Prüfung eingebetteter Tonspuren. +- **Anbieter-Catch-up ist derzeit deaktiviert.** Lokales Timeshift und Live-Aufnahmen bleiben verfügbar. +- DRM, HLS-Downloads und direkte OpenSubtitles-Suche sind nicht enthalten. +- Metadaten, Bildmaterial, Laufzeiten und Programmabdeckung hängen von den jeweiligen Quellen ab. + +## Speicherung + +Die installierte App speichert ihre verschlüsselten Daten unter `%LOCALAPPDATA%\Fluss IPTV`. Der interne Ordnername bleibt aus Kompatibilitätsgründen bestehen. Heruntergeladene Videos und Aufnahmen liegen im eingestellten Zielordner. + +Die Sicherung unter Einstellungen kann persönliche Zustände und optional Playlist-Zugänge exportieren. Videodateien werden dabei nicht mitgesichert. + +## Entwickeln und testen + +Die Entwicklerversion verwendet Hot Reload im laufenden Prozess. Codeänderungen werden über `dotnet watch` übernommen; Fenster, Wiedergabe und offene Dialoge bleiben dabei bestehen. Benannte XAML-Steuerelemente können ihre einfachen Eigenschaften direkt aktualisieren; `DesignTokens.xaml` und SVG-Symbole werden ebenfalls live geladen. Start über den Entwicklungs-Launcher oder `scripts/start-development.ps1`. Beim erstmaligen Wechsel einer älteren Entwicklungsinstanz in diesen Modus wird ihre Fensterposition und Größe übernommen. Ein laufender Hot-Reload-Prozess wird bei weiteren Starts lediglich in den Vordergrund geholt. + +Ein vorhandener, zum Quellstand passender Entwicklungsbuild öffnet das Fenster direkt; der Hot-Reload-Wächter verbindet sich anschließend im Hintergrund. Fehlende oder veränderte Builddateien erfordern einen Neubuild. Während der Initialisierung werden Quelländerungen vorgemerkt. Der normale Start zeigt kein separates Vorbereitungsfenster. + +Kompilierfehler lassen den bisherigen Stand geöffnet; nach der Korrektur werden unterstützte Änderungen nachgeladen. Änderungen an Elementstrukturen, nicht unterstützten XAML-Ausdrücken oder nicht nachladbare Codeänderungen lösen keinen automatischen Neustart aus. Sie bleiben bis zum nächsten bewussten Programmstart ausstehend. Nach einer von .NET zurückgewiesenen Codeänderung kann die Codeüberwachung bis zu diesem Start pausieren; die direkte Designaktualisierung bleibt aktiv. Diagnose: `artifacts/development/watcher.log`, `build.log` und `design-reload.log`. Die Tastatureingabe für die automatische Ablehnung von Neustarts wurde mit .NET SDK 10.0.401 geprüft. + +Der Launcher wird aus `scripts/DevelopmentLauncher.cs` und `scripts/DevelopmentWatch.cs` gemeinsam als Windows-Anwendung mit Referenz auf `System.Windows.Forms.dll` kompiliert. Entwicklerversionen zeigen im Fenstertitel und in den Einstellungen „Entwicklung“ mit der Build-Kennung. + +Live-Änderungen gelten für die bereits über Designwerte angebundenen Farben, Schriftgrößen und Abstände sowie vorhandene SVG-Symbole. Die SVGs verwenden eine `0 0 24 24`-Zeichenfläche und gefüllte Pfade (`path` mit `d` und `fill`). Unterstützte C#- und XAML-Änderungen werden über die beschriebene Hot-Reload-Anbindung übernommen. Neue eingebettete Ressourcen und nicht unterstützte Änderungen benötigen weiterhin einen Build und bewussten Neustart. Die installierte Release-Version lädt keine Entwicklungsdateien nach. + +Der Quellcode liegt in den privaten Repositories auf [GitHub](https://github.com/Sucukdeluxe/simple-tv) und [Forgejo](https://git.24-music.de/Administrator/simple-tv). Das [öffentliche Verteilungsrepository](https://git.24-music.de/Administrator/simple-tv-releases) enthält Dokumentation, Bilder und fertige Releases. + +```powershell +dotnet build src/Fluss.App -c Release +``` + +Testquellen, Fixtures, Prüfartefakte und `PROJECT_MEMORY.md` werden ausschließlich lokal gepflegt und sind nicht Teil des Repositories. Ein frischer Checkout lässt sich ohne diese Dateien bauen. Die folgenden Befehle setzen die lokal vorhandene Testsuite voraus: + +```powershell +dotnet run --project tests/Fluss.Tests -c Release +dotnet build tests/Fluss.LayoutTests +python tests/Fluss.LayoutTests/run-background-audit.py