196 lines
15 KiB
Markdown
196 lines
15 KiB
Markdown
<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.15" src="https://img.shields.io/badge/Release-1.1.15-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.15">Changelog 1.1.15</a>
|
||
</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.
|
||
|
||
## 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.15:** Kompakte Verlaufseinträge ohne aktuelle EPG-Sendung, dieselbe Klappanimation wie unter „Alle“ und besser lesbare Playlist-Informationen. Die Entwicklerversion übernimmt nach einer korrigierten, zuvor zurückgewiesenen Änderung wieder Live-Updates im offenen Fenster. Das [vollständige Changelog](https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v1.1.15) beschreibt alle Änderungen seit 1.1.14.
|
||
|
||
## 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.
|
||
|
||
### 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.
|
||
- „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.
|
||
- 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
|
||
|
||

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

|
||
|
||
## 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
|
||
```
|
||
|
||
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.
|