SlimIpTvPlayer Files

========================================================================
                      Slim IPTV Player & Recorder
========================================================================

Slim IPTV Player ist eine extrem schlanke, schnelle und modular 
aufgebaute IPTV-Anwendung auf Basis von Python 3 und PyQt6. Die App 
erlaubt das blockierfreie Laden von M3U-Wiedergabelisten, bietet eine 
integrierte Video-Vorschau bei einfachem Klick und öffnet bei einem 
Doppelklick ein vollwertiges Wiedergabefenster. Zudem verfügt das 
Programm über eine integrierte Aufnahme-Engine via FFmpeg mit Timer-Funktion.


FEATURES
------------------------------------------------------------------------
* Asynchroner M3U-Parser: Riesige Playlists blockieren das UI nicht.
* Intelligente Live-Vorschau: Einfacher Klick zeigt einen stummen Stream 
  direkt eingebettet in der App.
* Echtes Fernsehfenster: Doppelklick öffnet ein separates MPV-Fenster 
  mit vollem Ton.
* Verlustfreie Aufnahme: Stream-Kopie (Direct Stream Copy) via FFmpeg 
  ohne zeitintensive Neucodierung.
* Timer-Steuerung: Geplante Aufnahmen über intuitive Zeitauswahl-Widgets 
  (QTimeEdit) mit automatischem Mitternachts-Ausgleich.
* Themes: Schneller Wechsel zwischen stylischen Farbschemata (Zyan, 
  Orange, Grün) direkt über die GUI.
* MVC-Architektur: Hochgradig modularer Code, aufgeteilt in logische 
  Komponenten für maximale Erweiterbarkeit.


VORAUSSETZUNGEN FÜR DIE AUSFÜHRBARE BINÄRDATEI (Standalone-Version)
------------------------------------------------------------------------
Wenn Sie die fertig kompilierte Binärdatei (ausführbares Programm im 
'dist'-Ordner) verwenden, müssen Sie KEIN Python oder PyQt6 auf Ihrem 
System installieren, da alle Code-Bibliotheken bereits integriert sind.

Da das Programm jedoch im Hintergrund auf die Mediaplayer- und Aufnahme-
Systeme Ihres Computers zugreift, müssen die folgenden zwei Programme 
zwingend auf Ihrem Linux-System installiert sein, damit die Binärdatei 
fehlerfrei startet, Videos anzeigt und Aufnahmen speichert:

1. mpv    (Für die In-App-Vorschau und die Video-Wiedergabe)
2. ffmpeg (Für die manuelle Aufnahme und die Timer-Aufnahme)

Installieren Sie diese beiden System-Werkzeuge vor dem ersten Start 
der Binärdatei einfach mit folgendem Terminal-Befehl:

  sudo apt update
  sudo apt install mpv ffmpeg

Start der Binärdatei:
Klicken Sie doppelt auf die ausführbare Datei 'qt_iptv' oder starten 
Sie sie im Terminal über den Pfad:

  ./qt_iptv


VORAUSSETZUNGEN FÜR DEN QUELLCODE (Source Version)
------------------------------------------------------------------------
Falls Sie das Programm direkt aus den Python-Skripten heraus starten 
möchten, benötigen Sie Python 3, die PyQt6-Bibliothek sowie die 
System-Anwendungen 'mpv' und 'ffmpeg'.

Installieren Sie alle Abhängigkeiten einfach über das Terminal:

  sudo apt update
  sudo apt install python3-pip python3-pyqt6 mpv ffmpeg


ANLEITUNG: BINÄRDATEI SELBST BAUEN (Kompilieren via PyInstaller)
------------------------------------------------------------------------
Wenn Sie den Quellcode selbst in eine eigenständige, ausführbare 
Linux-Binärdatei umwandeln möchten, können Sie dies mithilfe von 
PyInstaller tun.

1. Installieren Sie PyInstaller über Ihr Terminal:
   pip install pyinstaller

2. Navigieren Sie in den Projektordner (wo die qt_iptv.py liegt) und 
   führen Sie folgenden Build-Befehl aus:
   pyinstaller --noconfirm --onedir --windowed qt_iptv.py

3. Nach erfolgreichem Durchlauf finden Sie im neuen Ordner 'dist/qt_iptv/' 
   die fertige ausführbare Datei 'qt_iptv'. 

4. Wichtig für die Weitergabe: Packen Sie immer den GESAMTEN Ordner 
   'dist/qt_iptv/' (z.B. als ZIP-Archiv), da dieser alle notwendigen 
   Qt6-Grafiktreiber und System-Bibliotheken enthält, die das Programm 
   auf anderen PCs zum Starten benötigt.


PROJEKT-STRUKTUR (Source Code)
------------------------------------------------------------------------
Das Projekt ist nach dem Model-View-Controller (MVC) Muster organisiert:

* qt_iptv.py          - Haupteinstiegspunkt (Entry Point) des Programms.
* player_logic.py     - Kern-Logik, State-Management und Widgets-Mapping.
* player_controller.py- Event-Verarbeitung und Benutzerinteraktionen.
* ui.py               - Definition des Layouts, der Splitter und Widgets.
* worker.py           - Konkrete Hintergrund-Threads (Playlist-Lader).
* base_worker.py      - Wiederverwendbare Basis-Struktur für Threads.
* parser.py           - Native und optimierte O(n) M3U-Parsing-Engine.
* recorder.py         - FFmpeg-Prozesssteuerung für Live-Aufnahmen & Timer.
* config.py           - Konfigurations-Manager für Pfade und JSON-Daten.
* theme.py            - Farb-Stylesheets (QSS) für das Anwendungs-Design.


STARTEN AUS DEM QUELLCODE
------------------------------------------------------------------------
Navigieren Sie im Terminal in den Quelltext-Ordner und führen Sie aus:

  python3 qt_iptv.py


BEDIENUNGSHINWEISE
------------------------------------------------------------------------
1. Speicherort festlegen: Wählen Sie oben über "Wählen..." den Ordner,
   in dem Ihre *.mp4 Aufnahmen landen sollen.
2. Playlists verwalten: Nutzen Sie die "+" und "-" Buttons unter der 
   linken Spalte, um M3U-URLs oder lokale Playlist-Dateien hinzuzufügen.
3. Vorschau vs. Wiedergabe: Ein Klick auf einen Sender startet die 
   stumme In-App-Vorschau oben. Ein Doppelklick öffnet den vollen Stream.
4. Timer setzen: Die Widgets starten mit sinnvollen Werten (Jetzt bis 
   Jetzt + 2 Std.). Passen Sie die Zeiten bequem mit den Pfeiltasten an.


------------------------------------------------------------------------
Entwickelt mit Fokus auf Performance, Stabilität und sauberen Code.
Veröffentlicht auf SourceForge.