Document Simple TV downloads and automatic updates

This commit is contained in:
2026-09-22 07:11:04 +02:00
parent 4153216901
commit 2374a5b864
+175 -149
View File
@@ -1,149 +1,175 @@
<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 0.10.0" src="https://img.shields.io/badge/Release-0.10.0-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/v0.10.0">Changelog 0.10.0</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 0.10.0:** gemeinsame Mediathek mit Fortsetzen, Multi-View für bis zu vier Streams, getrennte TV-/Filmwiedergabe, Aufnahmeübersicht, überarbeitete Downloads, dauerhafter Laufzeit-Cache sowie Korrekturen für Tonwechsel, Spulen und Fenster-Overlays. Das [vollständige Changelog](https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v0.10.0) beschreibt alle Änderungen seit 0.9.17.
## Funktionen
### Live-TV und Playlists
- Mehrere gespeicherte Playlists mit Suche, Länderfiltern, Senderlogos und Qualitätsvarianten.
- Aufklappbare Kategorien, anpinnbare Gruppen und gespeicherte Reihenfolge.
- Favoriten, 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.
- Eigener Aufnahmen-Tab mit Vorschau, Tagesgruppen, Suche und Statusfiltern.
- 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.
- Heruntergeladene Updates werden beim regulären Beenden installiert.
## 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** 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 | Anpinnen 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.
- Die App muss für geplante Aufnahmen und Erinnerungen laufen.
- 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.
<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 0.11.0" src="https://img.shields.io/badge/Release-0.11.0-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/v0.11.0">Changelog 0.11.0</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 0.11.0:** Update-Dialog mit vollständigen Versionshinweisen und Downloadfortschritt, Löschen von Downloads und Aufnahmen, überarbeitete Aufnahmeübersicht sowie Verbesserungen an Playlists, Länderwahl, EPG und Tastaturfokus. Das [vollständige Changelog](https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v0.11.0) beschreibt alle Änderungen seit 0.10.0.
## Funktionen
### Live-TV und Playlists
- Mehrere gespeicherte Playlists mit Suche, Länderfiltern, Senderlogos und Qualitätsvarianten.
- Aufklappbare Kategorien, anpinnbare Gruppen und gespeicherte Reihenfolge.
- Favoriten, 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.
- Eigener Aufnahmen-Tab mit Vorschau, Tagesgruppen, Suche und Statusfiltern.
- 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
![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** 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 | Anpinnen 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.
- Die App muss für geplante Aufnahmen und Erinnerungen laufen.
- 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
Der Quellcode liegt in den privaten Repositories auf [GitHub](https://github.com/Sucukdeluxe/fluss-iptv) und [Forgejo](https://git.24-music.de/Administrator/fluss-iptv). 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
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), [Projektstand](PROJECT_MEMORY.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.9.17 --full-only
dotnet run --project tests/Fluss.UpdateTests -c Release -- --public artifacts/releases-v0.9.17 --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.