===============================================================================
                         MU-APPLAUNCHER - Release 1.0.4
===============================================================================
Minimalistischer, flexibler GTK3-Anwendungs-Launcher & Desktop-Widget, 
optimiert für schlanke Window-Manager (z. B. IceWM unter Puppy Linux / BookwormPup).

-------------------------------------------------------------------------------
1. INBETRIEBNAHME & CLI-PARAMETER
-------------------------------------------------------------------------------
Der Launcher kann über verschiedene Kommandozeilen-Parameter gesteuert werden. 
CLI-Parameter überschreiben (Override) die Werte aus der Konfigurationsdatei.

Optionen:
  -h, --help       Zeigt die Hilfe an und beendet das Programm.
  -g, --debug      Aktiviert detaillierte X11-Positions-Diagnosen im Terminal.
  -d, --desktop    Widget-Modus: Betten Sie den Launcher permanent in den 
                   Desktop-Hintergrund ein. Verhindert jegliches Schließen.
  -t, --top        Erzwingt die Platzierung am oberen Bildschirmrand.
  -b, --bottom     Erzwingt die Platzierung am unteren Bildschirmrand.
  -l, --left       Erzwingt die Platzierung am linken Bildschirmrand.
  -r, --right      Erzwingt die Platzierung am rechten Bildschirmrand.
  -u, --autohide   Aktiviert die automatische Ausblendung (Edge-Trigger-Loop).
  -c, --config     <Pfad> Nutzt eine benutzerdefinierte Konfigurationsdatei.
  -a, --apps       <Pfad> Nutzt ein alternatives Verzeichnis für *.desktop-Starter.

-------------------------------------------------------------------------------
2. DIE KONFIGURATIONSDATEI (config.rc)
-------------------------------------------------------------------------------
Standardpfad: ~/.mu-applauncher/config.rc
Die Datei nutzt das Standard-INI/KeyFile-Format. Der Parser arbeitet komplett 
tolerat gegenüber Groß-/Kleinschreibung (Case-Insensitive) bei allen Schlüsseln.

Musteraufbau mit allen verfügbaren Optionen:

[Launcher]
X=100
Y=100
Center=true
BottomBar=false
TopBar=false
LeftBar=false
RightBar=false
Autohide=false
IconSize=64
FontSize=11
Columns=4
GridSpacing=15
TextColor=#BBBB88
HoverColor=rgba(255, 255, 255, 0.1)
BorderColor=#333333
BorderWidth=2
BackgroundImage=
IgnoreBgInDesktopMode=false
Bold=false
HideTextUntilHover=false
AutoCloseOnLeave=true
Xinerama=-1
Struts=false

-------------------------------------------------------------------------------
3. SONDERFÄLLE & VERSTECKTE LOGIKEN (Power-User-Features)
-------------------------------------------------------------------------------

* GridSpacing=-1 (Ultrabündiger Panel-Modus)
  Wenn 'GridSpacing=-1' gesetzt wird, reduziert der Launcher das interne Padding 
  und die Abstände aller Icons sowie des umgebenden Rahmens restlos auf 0 Pixel. 
  Gleichzeitig schrumpfen die Schaltflächen im CSS auf ein flaches Profil. Ideal, 
  um Mu-AppLauncher als nahtlose, native Systemleiste am Bildschirmrand zu nutzen.

* Automatische Fehlertoleranz & Dateireparatur
  - Sollte eine Zeile in der config.rc syntaktisch beschädigt sein (z. B. durch 
    einen Tippfehler wie "GridSpacing-1" statt "GridSpacing=-1"), fängt der 
    Parser dies vor dem GLib-Laden ab und repariert die Zeile im Speicher.
  - Fehlt das zwingend erforderliche Gruppentag '[Launcher]' am Anfang der Datei, 
    fügt das Programm dieses beim Start automatisch ein, ohne bestehende 
    Benutzereinstellungen zu löschen.

* Xinerama Multi-Monitor-Support
  Über den Schlüssel 'Xinerama=<Index>' (z. B. Xinerama=1) kann das Deck gezielt 
  auf einen bestimmten Bildschirm deines Multi-Monitor-Setups gezwungen werden.
  - Wert steht auf -1: Nutzt den aktuellen Bildschirm, auf dem die Maus liegt.
  - Wert steht auf >= 0: Erzwingt die Kantenplatzierung auf genau diesem Monitor.

* Intelligente X11-Struts (Platzreservierung für maximierte Fenster)
  Wenn 'Struts=true' aktiv ist, teilt der Launcher dem X11-Server via EWMH-Atomen 
  (_NET_WM_STRUT_PARTIAL) mit, dass hier Platz reserviert ist. Andere maximierte 
  Fenster (wie Browser oder Terminals) überlagern den Launcher dann nicht mehr.
  - Die Option wird im Desktop-Modus (-d) automatisch ignoriert.
  - Die Option wird im Center-Modus automatisch ignoriert.
  - Smarte Ecken-Weiche: Befindet sich das Deck in einer Ecke (z. B. Top + Right) 
    und ist hochkant (h > w, z. B. 1 Spalte breit), greift der Strut NUR an der 
    schmalen vertikalen Außenkante (rechts) und blockiert NICHT den oberen Rand!

* Automatisches Schließen (AutoCloseOnLeave)
  Wenn 'AutoCloseOnLeave=true' aktiv ist, schließt sich das Launcher-Fenster 
  sobald die Maus den Fensterbereich verlässt. 
  - Diese Funktion wird automatisch blockiert, solange das integrierte 
    Konfigurations-Editierfenster oder der Shortcut-Creator geöffnet sind.
  - Diese Funktion wird im Desktop-Widget-Modus (-d) permanent ignoriert.

* Sauberes X11-Prozessmanagement
  Alle Editor-Speichervorgänge und Verknüpfungs-Löschungen nutzen entkoppelte 
  Prozesse und ein synchronisiertes X11-Clipboard-Owner-System. Dadurch läuft 
  die App auch unter minimalistischen Window-Managern wie IceWM absolut stabil.