Document Simple TV downloads and automatic updates
This commit is contained in:
1 parent
cc7643dca3
commit
5b457e0c66
1 file changed
+193
-153
@@ -1,153 +1,193 @@
|
|||||||
<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 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="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/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>
|
</p>
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
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 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
|
## 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 mit eigenen Namen, anpinnbare Gruppen und gespeicherte Reihenfolge.
|
- Aufklappbare Kategorien mit eigenen Namen, anpinnbare Gruppen und gespeicherte Reihenfolge.
|
||||||
- Favoriten mit goldenen Sternen, eigene Favoritengruppen, Mehrfachauswahl und nach Tagen gegliederter Verlauf.
|
- Favoriten mit goldenen Sternen, 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.
|
||||||
- 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.
|
- 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.
|
- 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.
|
- 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.
|
||||||
- Der Update-Dialog zeigt beim Start alle veröffentlichten Änderungen zwischen installierter und angebotener Version. „Update verfügbar“ links neben „Einstellungen“ öffnet ihn erneut.
|
- 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.
|
- „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
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
### Programmübersicht
|
### Programmübersicht
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
## Erste Schritte
|
## Erste Schritte
|
||||||
|
|
||||||
1. Setup installieren oder die Portable-ZIP entpacken und `Simple TV.exe` öffnen.
|
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.
|
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.
|
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.
|
4. Bei einem Xtream-Angebot **Mediathek** öffnen und Filme oder Serien auswählen.
|
||||||
5. Unter **Einstellungen** Downloadordner, Darstellung, bevorzugte Sprachen und Wiedergabeoptionen festlegen.
|
5. Unter **Einstellungen** Downloadordner, Darstellung, bevorzugte Sprachen und Wiedergabeoptionen festlegen.
|
||||||
|
|
||||||
| Bedienung | Aktion |
|
| Bedienung | Aktion |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| F11 / Esc | Vollbild umschalten / verlassen |
|
| F11 / Esc | Vollbild umschalten / verlassen |
|
||||||
| Leertaste im Player | Pausieren / fortsetzen |
|
| Leertaste im Player | Pausieren / fortsetzen |
|
||||||
| Mausrad über dem Video | Lautstärke ändern |
|
| Mausrad über dem Video | Lautstärke ändern |
|
||||||
| Doppelklick auf das Video | Vollbild; im Miniplayer zur großen Wiedergabe |
|
| Doppelklick auf das Video | Vollbild; im Miniplayer zur großen Wiedergabe |
|
||||||
| Drei Punkte am Cover | Sehstatus, Fortsetzen und Datei speichern |
|
| Drei Punkte am Cover | Sehstatus, Fortsetzen und Datei speichern |
|
||||||
| Rechtsklick auf eine Kategorie | Umbenennen, Anpinnen, Favoriten und Reihenfolge verwalten |
|
| Rechtsklick auf eine Kategorie | Umbenennen, Anpinnen, Favoriten und Reihenfolge verwalten |
|
||||||
|
|
||||||
## Voraussetzungen und Grenzen
|
## Voraussetzungen und Grenzen
|
||||||
|
|
||||||
- Windows x64 und eine eigene unterstützte Quelle. Senderlisten und Anbieterzugänge werden nicht mitgeliefert.
|
- 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.
|
- 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.
|
- 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 benötigen die geöffnete App. Vollständiges Herunterfahren verhindert lokale Aufnahmen.
|
- 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.
|
- 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.
|
- **Anbieter-Catch-up ist derzeit deaktiviert.** Lokales Timeshift und Live-Aufnahmen bleiben verfügbar.
|
||||||
- DRM, HLS-Downloads und direkte OpenSubtitles-Suche sind nicht enthalten.
|
- DRM, HLS-Downloads und direkte OpenSubtitles-Suche sind nicht enthalten.
|
||||||
- Metadaten, Bildmaterial, Laufzeiten und Programmabdeckung hängen von den jeweiligen Quellen ab.
|
- 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.
|
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.
|
||||||
Reference in new issue
Block a user