Files
simple-tv-releases/README.md
T

208 lines
16 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.
<p align="center">
<img src="docs/images/app.png" width="80" alt="Simple TV">
</p>
<h1 align="center">Simple TV</h1>
<p align="center">Live-TV, Filme, Serien, Multi-View und Aufnahmen für Windows.</p>
<p align="center">
<a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/latest"><img alt="Release 1.1.22" src="https://img.shields.io/badge/Release-1.1.22-22b455"></a>
<img alt="Windows x64" src="https://img.shields.io/badge/Windows-x64-0078D6">
<img alt=".NET 10 und WPF" src="https://img.shields.io/badge/.NET-10%20%2F%20WPF-512BD4">
<img alt="LibVLC" src="https://img.shields.io/badge/Player-LibVLC-f58220">
</p>
<p align="center">
<a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/latest">Download</a> ·
<a href="#funktionen">Funktionen</a> ·
<a href="#beispielbilder">Beispielbilder</a> ·
<a href="#erste-schritte">Erste Schritte</a> ·
<a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v1.1.22">Changelog 1.1.22</a>
</p>
![Simple TV: Mediathek mit Film- und Serienreihen](docs/images/media-library.png)
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.22:** Letzte Ansicht nach dem Neustart, EPG-Suche über alle geladenen Tage und eine gemeinsame Kopfzeile für Mediathek und Downloads.
## Funktionen
### Live-TV und Playlists
- Mehrere gespeicherte Playlists mit Suche, Länderfiltern, Senderlogos und direkter Auswahl von Qualitätsvarianten.
- Tatsächliche Streamauflösung aus der Wiedergabe, getrennt je Playlist gespeichert; zusätzliche Prüfungen nur auf Anforderung.
- 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 und Serien einschließlich Titellogos.
- Bereits geladene Mediatheken werden beim Wechsel zwischen Playlists wiederverwendet.
- Beim nächsten Start erscheint die zuletzt geladene Übersicht frühzeitig; der vollständige Katalog wird währenddessen aktualisiert.
### 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
Der Pfeil rechts im Live-TV-Button öffnet die Auswahl **TV-Programm (EPG)**. Die Programmübersicht erscheint als Seite im Hauptfenster. Ein Klick auf **Live-TV** führt zurück zum Player. Suchtext, Datum und Auswahl bleiben beim Seitenwechsel erhalten. Ein Doppelklick auf einen Sender, eine Sendung oder einen Suchtreffer startet den Sender im Miniplayer, während die Programmübersicht geöffnet bleibt.
- EPG aus XMLTV/XMLTV.gz mit farbigen Sendungskarten, Logozeilen, Suche und Zeitnavigation.
- Suche über alle geladenen Programmtage mit Datum pro Treffer; auf Wunsch auf den gewählten Tag beschränkt.
- Manuelle Senderzuordnung und ergänzende deutsche Programmdaten.
- „Jetzt und danach“ mit aktueller Sendung, bis zu fünf Folgesendungen, Details und verfügbaren EPG-Bildern.
- 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.
- Letzte Seite, Filter, Suchtext und Scrollposition nach einem Neustart wiederherstellen; unter Allgemein abschaltbar. Die Wiederherstellung startet keine Wiedergabe.
- Einzelstreams nach Rückkehr der Netzwerkverbindung oder nach Standby erneut verbinden; Pause, Stopp und Senderwechsel bleiben maßgeblich.
- 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
![Filmübersicht mit Sprach-/Genrefiltern und geöffneter Detailvorschau](docs/images/media-details.png)
### Programmübersicht
![TV-Programm mit Senderlogos, Sendungskarten und Zeitachse](docs/images/programme-guide.png)
## 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.
Nach Quelländerungen wird ein geprüfter Entwicklungsbuild für den nächsten Start im Hintergrund vorbereitet. 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. Der Launcher verwendet eine lokal vorbereitete Kopie des .NET-Wächters: Zurückgewiesene Codeänderungen werden verworfen, ohne die Überwachung dauerhaft anzuhalten. Nach der Korrektur können unterstützte Änderungen im selben Fenster weiter übernommen werden. Das installierte SDK bleibt unverändert; die lokale Kopie wird pro SDK- und Helferstand geprüft und zwischengespeichert. 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. `scripts/DevelopmentWatchTool` bereitet den lokalen Wächter beim ersten Bedarf vor und lehnt unbekannte Binärlayouts ab. 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
```
Der versionierte Navigationstest prüft die EPG-Seite auf einem isolierten Windows-Desktop mit synthetischen Daten und einem lokalen, stummen Teststream:
```powershell
python tests/Fluss.NavigationTests/run.py <Pfad-zu-dotnet.exe>
```
Er baut die App und erzeugt benötigte Testmedien selbst. `--continuity` prüft zusätzlich Mehrtagessuche, gespeicherte Ansichten, frühe Mediathek-Inhalte und Verbindungswiederaufnahme. `--restart-proof` prüft die Ansichtsübernahme zwischen zwei getrennten Programmprozessen. Netzwerk- und Standby-Ereignisse werden simuliert; der Teststream wird tatsächlich dekodiert. Ergebnisse bleiben unter `artifacts/`. Weitere ältere Tests sind nur lokal vorhanden; die folgenden Befehle setzen diese Testsuite voraus:
```powershell
dotnet run --project tests/Fluss.Tests -c Release
dotnet build tests/Fluss.LayoutTests
python tests/Fluss.LayoutTests/run-background-audit.py <Pfad-zu-dotnet.exe>
```
Die Hintergrund-Prüfgruppen laufen auf privaten Windows-Testdesktops, ohne auf den aktiven Desktop zu wechseln. Sie verwenden isolierte Daten, stumme Testmedien und Software-Rendering. Lokale Medienfixtures unter `artifacts/media` sind Voraussetzung. `FLUSS_DATA_DIR` wählt ein separates Datenverzeichnis.
Weitere technische Nachweise: [Player](docs/PLAYER.md), [Multi-View](docs/MULTIVIEW.md), [Beispielbilder](docs/SCREENSHOTS.md).
### Release erstellen
```powershell
./scripts/build-release.ps1 -Dotnet <Pfad-zu-dotnet.exe>
dotnet run --project tests/Fluss.UpdateTests -c Release -- artifacts/releases-stable artifacts/releases-v0.16.0 --full-only
dotnet run --project tests/Fluss.UpdateTests -c Release -- --public artifacts/releases-v0.16.0 --full-only
```
Version erhöhen und gleichwertige Changelogs unter `releases/` pflegen: Englisch auf GitHub, Deutsch auf Forgejo. App-ID `SimpleTV`, Kanal `win` und öffentliche Update-Adresse bleiben stabil. Releases verwenden vollständige Pakete; bestehende Versionen werden nicht überschrieben.
Nur Dateien aus dem aktuellen `assets.win.json` sowie Update-Metadaten und Prüfsummen veröffentlichen. Veröffentlichung über Entwürfe, anschließend alle Dateien erneut herunterladen und prüfen. Das öffentliche Repository darf keinen Programmquellcode, keine Nutzerdaten und keine Zugangsdaten enthalten.
Drittanbieter-Lizenzen und Quellcodeverweise: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) und `licenses/`. Die gepatchten VLC-Audiomodule werden mit vollständigem Quellarchiv und Bauanleitung im Programm ausgeliefert.