MP3-Wecker Files

===============================================================================
                       MP3-Wecker für Linux Mint (PulseAudio)
===============================================================================

Ein minimalistischer, rahmenloser MP3-Wecker mit intelligentem Audio-Bypass,
speziell entwickelt für Linux-Systeme.

-------------------------------------------------------------------------------
FEATURES & DESIGN
-------------------------------------------------------------------------------
* GUI Design: Elegantes Dark Theme im rahmenlosen Design mit abgerundeten Ecken,
  farbigen Rändern und einer dezenten Transparenz (90% Deckkraft).
* Platzierung: Startet vollautomatisch oben rechts auf dem Bildschirm.
* Flexibilität: Kann mit der linken Maustaste an jede beliebige Stelle auf dem
  Desktop verschoben werden.
* Anzeigen: Große digitale Uhrzeitanzeige und ein sekundengenauer Countdown,
  der anzeigt, wie lange es noch bis zum nächsten Alarm dauert.
* Steuerung: Weckzeit-Einstellung über drei Comboboxen (Stunde, Minute, Sekunde)
  und gezielte Auswahl der Wochentage über Checkboxen. Die Aktivierung erfolgt 
  über zwei große (60x60px) EIN / AUS Buttons auf der rechten Seite.
* Dateipfade: MP3-Pfad kann direkt über eine Textbox eingetippt oder bequem 
  über einen "MP3..."-Auswahldialog gewählt werden.

-------------------------------------------------------------------------------
DER LAUTSTÄRKE-BYPASS (Das Herzstück für Linux)
-------------------------------------------------------------------------------
Das Programm löst das bekannte Linux-Problem, dass Wecker überhört werden, 
wenn das System leise oder stummgeschaltet (Mute) ist:

1. Beim Alarm wird die Hauptlautstärke der Soundkarte (Master-Sink) über 
   PulseAudio/PipeWire augenblicklich auf 100% hochgerissen und unmutet.
2. Die ausgewählte MP3-Datei spielt in einer echten Endlosschleife.
3. Sobald Sie auf den roten "AUS"-Button drücken, stoppt die Musik und das 
   System springt exakt auf die Lautstärke zurück, die VOR dem Alarm 
   eingestellt war (auch zurück in den Stummmodus).

-------------------------------------------------------------------------------
BEDIENUNG & STATUSLEISTE (System-Tray)
-------------------------------------------------------------------------------
* Fenster schließen (In den Hintergrund verschieben):
  Klicken Sie auf das kleine "x" oben links oder drücken Sie die "ESC"-Taste. 
  Das Fenster verschwindet vom Desktop, bleibt aber als Wecker-Symbol unten 
  rechts in der Statusleiste aktiv. Der Alarm läuft im Hintergrund weiter.
* Fenster wieder öffnen:
  Machen Sie einfach einen Doppelklick auf das Wecker-Symbol in der Statusleiste.
* Einstellungen merken:
  Das Programm merkt sich beim Aktivieren/Deaktivieren automatisch die Weckzeit, 
  die Wochentage, die Lautstärke und den MP3-Pfad. Die Konfiguration wird in der 
  Datei "wecker_settings.json" immer direkt im selben Ordner wie der Wecker 
  gespeichert.
* Programm komplett beenden:
  Machen Sie einen Rechtsklick auf das Wecker-Symbol in der Statusleiste und 
  wählen Sie "Beenden".

-------------------------------------------------------------------------------
START & AUSFÜHRBARE DATEI (Doppelklick einrichten)
-------------------------------------------------------------------------------
Falls Sie die kompilierte Binärdatei ("Wecker") nutzen, müssen Sie Linux Mint 
einmalig erlauben, diese per Doppelklick zu öffnen:

1. Rechtsklick auf die Datei "Wecker" -> "Eigenschaften".
2. Wechseln Sie auf den Reiter "Zugriffsrechte" (Permissions).
3. Setzen Sie den Haken bei "Datei als Programm ausführen" (Allow executing file 
   as program).

Ab jetzt startet das Programm bequem per Doppelklick.

-------------------------------------------------------------------------------
LIZENZ & RECHTLICHES (GPLv3)
-------------------------------------------------------------------------------
Dieses Programm ist Freie Software und steht unter den Bedingungen der 
GNU General Public License Version 3 (GPLv3), da es die Open-Source-Bibliothek 
PyQt6 einbindet. 

* Kopieren, Modifizieren und Weitergabe sind ausdrücklich erlaubt.
* Bei einer Weitergabe des Programms (ob als Quellcode oder kompilierte Binärdatei) 
  muss der Quellcode unter denselben GPLv3-Bedingungen frei zugänglich bleiben.
* HAFTUNGSAUSSCHLUSS: Die Bereitstellung erfolgt absolut ohne Gewährleistung 
  oder Garantie. Der Autor haftet in keinem Fall für eventuelle Schäden – 
  einschließlich, aber nicht beschränkt auf ein Verschlafen durch einen 
  technischen Fehler oder Fehlfunktionen des Audiosystems.

Die vollständigen Lizenzbedingungen befinden sich in der Datei LICENSE.txt oder 
unter <https://gnu.org>.
===============================================================================