Document Simple TV downloads and automatic updates

This commit is contained in:
Administrator committed 2026-10-25 18:17:09 +01:00
1 parent cc7643dca3
commit 5b457e0c66
1 file changed
+48 -8
+48 -8
View File
@@ -7,7 +7,7 @@
<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.9" src="https://img.shields.io/badge/Release-1.1.9-22b455"></a>
<a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/latest"><img alt="Release 1.1.10" src="https://img.shields.io/badge/Release-1.1.10-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">
@@ -18,7 +18,7 @@
<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.9">Changelog 1.1.9</a>
<a href="https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v1.1.10">Changelog 1.1.10</a>
</p>
![Simple TV: Mediathek mit Film- und Serienreihen](docs/images/media-library.png)
@@ -38,7 +38,7 @@ Simple TV spielt eigene **M3U-Dateien, M3U-Links und Xtream-Codes-Zugänge** ab.
.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.
**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
@@ -78,7 +78,7 @@ Simple TV spielt eigene **M3U-Dateien, M3U-Links und Xtream-Codes-Zugänge** ab.
- 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.
- 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.
@@ -135,8 +135,8 @@ Die Bilder zeigen die tatsächliche Oberfläche mit **isolierten Beispieldaten**
- 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.
- 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.
@@ -148,6 +148,46 @@ Die installierte App speichert ihre verschlüsselten Daten unter `%LOCALAPPDATA%
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.
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 <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.