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"> <p align="center">
<img src="docs/images/app.png" width="80" alt="Simple TV"> <img src="docs/images/app.png" width="80" alt="Simple TV">
</p> </p>
<h1 align="center">Simple TV</h1> <h1 align="center">Simple TV</h1>
<p align="center">Live-TV, Filme, Serien, Multi-View und Aufnahmen für Windows.</p> <p align="center">Live-TV, Filme, Serien, Multi-View und Aufnahmen für Windows.</p>
<p align="center"> <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> <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="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=".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"> <img alt="LibVLC" src="https://img.shields.io/badge/Player-LibVLC-f58220">
</p> </p>
<p align="center"> <p align="center">
<a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/latest">Download</a> · <a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/latest">Download</a> ·
<a href="#funktionen">Funktionen</a> · <a href="#funktionen">Funktionen</a> ·
<a href="#beispielbilder">Beispielbilder</a> · <a href="#beispielbilder">Beispielbilder</a> ·
<a href="#erste-schritte">Erste Schritte</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> <a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v0.11.0">Changelog 0.11.0</a>
</p> </p>
![Simple TV: Mediathek mit Film- und Serienreihen](docs/images/media-library.png) ![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. 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 ## Download
**[Aktuelle Version für Windows herunterladen](https://git.24-music.de/Administrator/simple-tv-releases/releases/latest)** **[Aktuelle Version für Windows herunterladen](https://git.24-music.de/Administrator/simple-tv-releases/releases/latest)**
| Datei | Verwendung | | Datei | Verwendung |
| --- | --- | | --- | --- |
| `SimpleTV-win-Setup.exe` | Installation mit Desktop- und Startmenü-Verknüpfung | | `SimpleTV-win-Setup.exe` | Installation mit Desktop- und Startmenü-Verknüpfung |
| `SimpleTV-win-Portable.zip` | Entpacken und ohne Installer starten | | `SimpleTV-win-Portable.zip` | Entpacken und ohne Installer starten |
| `SHA256SUMS.txt` | SHA-256-Prüfsummen der veröffentlichten Dateien | | `SHA256SUMS.txt` | SHA-256-Prüfsummen der veröffentlichten Dateien |
| `SimpleTV-…-full.nupkg` und Update-Metadaten | Automatische Aktualisierung; nicht manuell entpacken | | `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. .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. **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 ## Funktionen
### Live-TV und Playlists ### Live-TV und Playlists
- Mehrere gespeicherte Playlists mit Suche, Länderfiltern, Senderlogos und Qualitätsvarianten. - Mehrere gespeicherte Playlists mit Suche, Länderfiltern, Senderlogos und Qualitätsvarianten.
- Aufklappbare Kategorien, anpinnbare Gruppen und gespeicherte Reihenfolge. - Aufklappbare Kategorien, anpinnbare Gruppen und gespeicherte Reihenfolge.
- Favoriten, eigene Favoritengruppen, Mehrfachauswahl und nach Tagen gegliederter Verlauf. - Favoriten, eigene Favoritengruppen, Mehrfachauswahl und nach Tagen gegliederter Verlauf.
- Hintergrundimport und virtuelle Senderlisten für große Kataloge. - Hintergrundimport und virtuelle Senderlisten für große Kataloge.
- Playlist Manager zum Hinzufügen, Bearbeiten und Aktualisieren von Quellen. - 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. - Getrennte TV- und Filmsitzungen: TV kann beim Filmstart stumm weiterlaufen, soweit die verfügbaren Verbindungen ausreichen.
### Mediathek und Fortsetzen ### Mediathek und Fortsetzen
- Startseite mit Fortsetzen, beliebten Filmen/Serien und Neuerscheinungen. - Startseite mit Fortsetzen, beliebten Filmen/Serien und Neuerscheinungen.
- Entdecken mit Genre- und Sprachfiltern, vollständigen Rasterreihen und Nachladekarten. - Entdecken mit Genre- und Sprachfiltern, vollständigen Rasterreihen und Nachladekarten.
- Empfehlungen werden mit dem eigenen Playlist-Angebot abgeglichen. - Empfehlungen werden mit dem eigenen Playlist-Angebot abgeglichen.
- Detailansichten mit Covern, Titellogos, Hintergrundbildern, Bewertungen und Folgenauswahl. - Detailansichten mit Covern, Titellogos, Hintergrundbildern, Bewertungen und Folgenauswahl.
- Merkliste, Gesehen-/Ungesehen-Status und Fortschritt für Filme, Serien und lokale Downloads. - 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. - Nächste ungesehene Folge direkt in Fortsetzen; Titel bei Bedarf aus der Reihe entfernen.
- Dauerhafter Detail-/Laufzeit-Cache und begrenztes Vorladen sichtbarer Filme. - Dauerhafter Detail-/Laufzeit-Cache und begrenztes Vorladen sichtbarer Filme.
- Bereits geladene Mediatheken werden beim Wechsel zwischen Playlists wiederverwendet. - Bereits geladene Mediatheken werden beim Wechsel zwischen Playlists wiederverwendet.
### Player und Multi-View ### Player und Multi-View
- Bis zu vier Live-Streams mit eigener Steuerung, Tonquelle und Aufnahmefunktion. - Bis zu vier Live-Streams mit eigener Steuerung, Tonquelle und Aufnahmefunktion.
- Einzelstream-Vollbild sowie gemeinsames Vollbild, Kinomodus, Miniplayer und Pop-out. - Einzelstream-Vollbild sowie gemeinsames Vollbild, Kinomodus, Miniplayer und Pop-out.
- Ziehbares Pop-out mit Größenänderung und optional „Immer im Vordergrund“. - Ziehbares Pop-out mit Größenänderung und optional „Immer im Vordergrund“.
- Wiedergabegeschwindigkeit von 0,25× bis 4×, Zeitleiste und Vor-/Rücksprünge. - Wiedergabegeschwindigkeit von 0,25× bis 4×, Zeitleiste und Vor-/Rücksprünge.
- Tonspurwahl, eingebettete Untertitel, lokale Untertiteldateien und anpassbare Untertiteldarstellung. - Tonspurwahl, eingebettete Untertitel, lokale Untertiteldateien und anpassbare Untertiteldarstellung.
- Lautstärkeregler, Prozentfeld und Mausradsteuerung; optionale zusätzliche Verstärkung. - Lautstärkeregler, Prozentfeld und Mausradsteuerung; optionale zusätzliche Verstärkung.
- Bevorzugte Sprachen, automatische nächste Folge und Einschlaftimer. - 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. - Native Audioübergänge erhalten vorhandene Puffer; Verfügbarkeit und Format der Quelle bestimmen weiterhin das Verhalten.
### Programmübersicht und Aufnahmen ### Programmübersicht und Aufnahmen
- EPG aus XMLTV/XMLTV.gz mit farbigen Sendungskarten, Logozeilen, Suche und Zeitnavigation. - EPG aus XMLTV/XMLTV.gz mit farbigen Sendungskarten, Logozeilen, Suche und Zeitnavigation.
- Manuelle Senderzuordnung und ergänzende deutsche Programmdaten. - Manuelle Senderzuordnung und ergänzende deutsche Programmdaten.
- Direktaufnahmen, geplante Aufnahmen und Erinnerungen. - Direktaufnahmen, geplante Aufnahmen und Erinnerungen.
- Eigener Aufnahmen-Tab mit Vorschau, Tagesgruppen, Suche und Statusfiltern. - Eigener Aufnahmen-Tab mit Vorschau, Tagesgruppen, Suche und Statusfiltern.
- MP4-Export im Hintergrund, datierte Aufnahmeordner und Dateiabgleich. - MP4-Export im Hintergrund, datierte Aufnahmeordner und Dateiabgleich.
- Lokales Timeshift zum Pausieren und Zurückspringen im verfügbaren Puffer. - Lokales Timeshift zum Pausieren und Zurückspringen im verfügbaren Puffer.
### Downloads und Warteschlange ### Downloads und Warteschlange
- Filme und einzelne Folgen direkt aus der Mediathek herunterladen. - Filme und einzelne Folgen direkt aus der Mediathek herunterladen.
- Warteschlangen-Dropdown mit Status sowie eigener Downloads-Tab. - Warteschlangen-Dropdown mit Status sowie eigener Downloads-Tab.
- Grüner Fortschritt, Dateigröße, Geschwindigkeit und geschätzte Restzeit. - Grüner Fortschritt, Dateigröße, Geschwindigkeit und geschätzte Restzeit.
- Pause/Fortsetzen und Wiederaufnahme nach Neustart, sofern die Quelle Teilabfragen unterstützt. - Pause/Fortsetzen und Wiederaufnahme nach Neustart, sofern die Quelle Teilabfragen unterstützt.
- Vorhandene Teildateien bleiben bei ungeeigneten Range-Antworten erhalten. - Vorhandene Teildateien bleiben bei ungeeigneten Range-Antworten erhalten.
- Fertige Downloads abspielen und mit derselben Fortsetzen-Liste weiterschauen. - Fertige Downloads abspielen und mit derselben Fortsetzen-Liste weiterschauen.
### Darstellung, Daten und Updates ### Darstellung, Daten und Updates
- Dark- und Light-Theme, anpassbare Covergrößen und skalierbare Bedienelemente. - Dark- und Light-Theme, anpassbare Covergrößen und skalierbare Bedienelemente.
- Lokal verschlüsselte Playlist-Zugänge, Bibliothek und Wiedergabestände. - Lokal verschlüsselte Playlist-Zugänge, Bibliothek und Wiedergabestände.
- Passwortverschlüsselte Sicherung und Wiederherstellung. - Passwortverschlüsselte Sicherung und Wiederherstellung.
- Updateprüfung beim Start und regelmäßig im Hintergrund. - Updateprüfung beim Start und regelmäßig im Hintergrund.
- Heruntergeladene Updates werden beim regulären Beenden installiert. - 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
## 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.
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
### Entdecken und Titeldetails
![Filmübersicht mit Sprach-/Genrefiltern und geöffneter Detailvorschau](docs/images/media-details.png)
![Filmübersicht mit Sprach-/Genrefiltern und geöffneter Detailvorschau](docs/images/media-details.png)
### Programmübersicht
### Programmübersicht
![TV-Programm mit Senderlogos, Sendungskarten und Zeitachse](docs/images/programme-guide.png)
![TV-Programm mit Senderlogos, Sendungskarten und Zeitachse](docs/images/programme-guide.png)
## Erste Schritte
## 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. 1. Setup installieren oder die Portable-ZIP entpacken und `Simple TV.exe` öffnen.
3. In **Live-TV** einen Sender auswählen. Für Programmdaten bei Bedarf eine EPG-Quelle zuweisen. 2. Über ** Playlist** eine M3U-Datei, einen M3U-Link oder einen Xtream-Zugang hinzufügen.
4. Bei einem Xtream-Angebot **Mediathek** öffnen und Filme oder Serien auswählen. 3. In **Live-TV** einen Sender auswählen. Für Programmdaten bei Bedarf eine EPG-Quelle zuweisen.
5. Unter **Einstellungen** Downloadordner, Darstellung, bevorzugte Sprachen und Wiedergabeoptionen festlegen. 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 |
| --- | --- | | Bedienung | Aktion |
| F11 / Esc | Vollbild umschalten / verlassen | | --- | --- |
| Leertaste im Player | Pausieren / fortsetzen | | F11 / Esc | Vollbild umschalten / verlassen |
| Mausrad über dem Video | Lautstärke ändern | | Leertaste im Player | Pausieren / fortsetzen |
| Doppelklick auf das Video | Vollbild; im Miniplayer zur großen Wiedergabe | | Mausrad über dem Video | Lautstärke ändern |
| Drei Punkte am Cover | Sehstatus, Fortsetzen und Datei speichern | | Doppelklick auf das Video | Vollbild; im Miniplayer zur großen Wiedergabe |
| Rechtsklick auf eine Kategorie | Anpinnen und Reihenfolge verwalten | | Drei Punkte am Cover | Sehstatus, Fortsetzen und Datei speichern |
| Rechtsklick auf eine Kategorie | Anpinnen und Reihenfolge verwalten |
## Voraussetzungen und Grenzen
## 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. - Windows x64 und eine eigene unterstützte Quelle. Senderlisten und Anbieterzugänge werden nicht mitgeliefert.
- Die App muss für geplante Aufnahmen und Erinnerungen laufen. - Gleichzeitige Streams und Aufnahmen benötigen ausreichend erlaubte Anbieter-Verbindungen.
- Verfügbare Sprachen in der Mediathek bezeichnen Playlist-Versionen; sie sind keine vollständige Prüfung eingebetteter Tonspuren. - Die App muss für geplante Aufnahmen und Erinnerungen laufen.
- **Anbieter-Catch-up ist derzeit deaktiviert.** Lokales Timeshift und Live-Aufnahmen bleiben verfügbar. - Verfügbare Sprachen in der Mediathek bezeichnen Playlist-Versionen; sie sind keine vollständige Prüfung eingebetteter Tonspuren.
- DRM, HLS-Downloads und direkte OpenSubtitles-Suche sind nicht enthalten. - **Anbieter-Catch-up ist derzeit deaktiviert.** Lokales Timeshift und Live-Aufnahmen bleiben verfügbar.
- Metadaten, Bildmaterial, Laufzeiten und Programmabdeckung hängen von den jeweiligen Quellen ab. - DRM, HLS-Downloads und direkte OpenSubtitles-Suche sind nicht enthalten.
- Metadaten, Bildmaterial, Laufzeiten und Programmabdeckung hängen von den jeweiligen Quellen ab.
## Speicherung
## 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 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.
Die Sicherung unter Einstellungen kann persönliche Zustände und optional Playlist-Zugänge exportieren. Videodateien werden dabei nicht mitgesichert.
## Verteilung und Lizenzen
## Entwickeln und testen
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.
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.