176 lines
11 KiB
Markdown
176 lines
11 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 0.12.0" src="https://img.shields.io/badge/Release-0.12.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.12.0">Changelog 0.12.0</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 0.12.0:** Unabhängige Playlist-Auswahl im TV-Programm, schnellere Playlist- und Senderwechsel, stabile Kategorien, farbige Mediathek-Detailansichten, Folgenkarten, Download-Mehrfachauswahl und zuverlässigeres Beenden. Das [vollständige Changelog](https://git.24-music.de/Administrator/simple-tv-releases/releases/tag/v0.12.0) beschreibt alle Änderungen seit 0.11.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
|
||
|
||
|
||
|
||
### Programmübersicht
|
||
|
||
|
||
|
||
## 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/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
|
||
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.
|