====== GuideOS Conky Configurator ======

===== Übersicht =====
{{ :guideos-conky-konfigurator-3.png?200|}}
Der **GuideOS Conky Configurator** ist ein GTK4/Libadwaita GUI-Tool zum Erstellen und Anpassen von Conky-Konfigurationen für den Cinnamon Desktop.




===== Zweck =====

Das Tool ermöglicht die benutzerfreundliche Konfiguration des Conky-Systemmonitors ohne manuelle Bearbeitung von Konfigurationsdateien. Es bietet eine grafische Oberfläche zur Anpassung von Aussehen, Positionierung, Systeminformationsanzeige und Autostart-Einstellungen.

===== Komponenten =====

Das System besteht aus drei Dateien:

^ Datei ^ Zweck ^
| ''guideos-conky-configurator'' | Haupt-GUI-Anwendung (Python/GTK4) |
| ''hwinfo.py'' | Hardware-Informationen sammeln (CPU, RAM, GPU, Netzwerk, Disk) |
| ''check-update.py'' | System-Updates zählen (APT und Flatpak) |

===== Hauptfunktionen =====

<WRAP round info 70%>
  * **Logo-Anzeige**: Auswahl und Positionierung eigener Logos
  * **Schriftarten**: Nerd Fonts mit verschiedenen Größen und Stilen
  * **Farbschemas**: Textfarbe, Akzentfarbe, Hintergrundfarbe anpassbar
  * **Transparenz**: Hintergrund-Transparenz mit Alpha-Werten
  * **Positionierung**: 9 Ausrichtungsoptionen, Multi-Monitor-Unterstützung
  * **Systeminformationen**: Auswahl und Sortierung angezeigter Informationen
  * **Live-Vorschau**: Testmodus ohne Speichern
  * **Autostart**: Automatischer Start beim Systemstart
</WRAP>


===== Bedienung =====

==== Programm starten ====


''guideos-conky-configurator''


Oder aus dem Anwendungsmenü.

==== Konfiguration erstellen ====
{{ :guideos-conky-konfigurator-1.png?300|}}
**1. Logo-Einstellungen**
  - Logo-Datei aus Dropdown wählen
  - Größe anpassen (20-200 Pixel)
  - Horizontalen und vertikalen Abstand einstellen
  - Abstand zur ersten Textzeile festlegen

**2. Erscheinungsbild**
  - **Schriftart**: Nerd Font auswählen (z.B. UbuntuMono, FiraCode, JetBrainsMono)
  - **Schriftgrößen**: Klein (6-24), Mittel (6-24), Groß (6-32)
  - **Schriftstile**: Regular, Bold, Italic, Light, Medium, etc.
  - **Textfarbe**: Hauptfarbe für Text
  - **Akzentfarbe**: Farbe für Hervorhebungen
  - **Hintergrundfarbe**: Farbe des Conky-Fensters
  - **Transparenter Hintergrund**: Ein/Aus
  - **Alpha-Wert**: 0 (vollständig transparent) bis 255 (vollständig opak)
  - **Zeilenabstand**: Leerzeilen zwischen Kategorien (0-3)

**3. Position**
  - **Monitor**: 0 = primärer Monitor
  - **Ausrichtung**: 9 Optionen (oben/mitte/unten × links/mitte/rechts)
  - **Horizontaler Abstand**: Pixel zum Bildschirmrand
  - **Vertikaler Abstand**: Pixel zum Bildschirmrand
{{ :guideos-conky-konfigurator-2.png?300|}}
**4. Systeminformationen**
  - Informationen per Checkbox aktivieren/deaktivieren
  - Mit Auf/Ab-Buttons sortieren
  - Trennlinien zwischen Abschnitten einfügen
  - Update-Intervalle für dynamische Informationen anpassen

**5. Autostart**
  - **Autostart aktivieren**: Conky startet automatisch beim Login

**6. Test und Speichern**
  - **Test-Button**: Vorschau ohne Speichern
  - **Speichern-Button**: Konfiguration anwenden und sichern

===== Verfügbare Systeminformationen =====

^ Information ^ Update-Typ ^ Intervall ^
| **Hostname** | Statisch | - |
| **Kernel** | Statisch | - |
| **Laufzeit** | Statisch | - |
| **Updates** | Dynamisch | 15 Min. (900s) |
| **CPU** | Dynamisch | 6 Std. (21600s) |
| **RAM** | Dynamisch | 10 Sek. |
| **GPU** | Dynamisch | 6 Std. |
| **GPU Treiber** | Dynamisch | 6 Std. |
| **GPU Speicher** | Dynamisch | 6 Std. |
| **Netzwerk** | Dynamisch | 10 Sek. |
| **Disk(s)** | Dynamisch | 10 Sek. |

===== Hilfsskripte =====

==== hwinfo.py ====

Sammelt Hardware-Informationen für Conky.

**Verwendung**:
<block round box 70%>
<code bash>
python3 hwinfo.py cpu          # CPU-Modell
python3 hwinfo.py ram          # RAM-Informationen
python3 hwinfo.py gpu          # GPU-Modell
python3 hwinfo.py gpu_driver   # GPU-Treiber-Version
python3 hwinfo.py gpu_memory   # GPU-Speicher (total/free)
python3 hwinfo.py net          # Netzwerk-Informationen (LAN/WAN IPv4/IPv6)
python3 hwinfo.py disk         # Festplatten-Nutzung
</code>
</block>


**Funktionen**:
<WRAP round tip 70%>
  * Automatische GPU-Erkennung (NVIDIA, AMD, Intel)
  * Treiber-Versions-Erkennung
  * WAN IP-Ermittlung über externe API
  * Festplatten-Label-Unterstützung
  * Mehrsprachige Ausgabe (gettext)
</WRAP>


==== check-update.py ====

Zählt verfügbare System-Updates für Conky.

**Verwendung**:
<block round box 70%>
<code bash>
python3 check-update.py
</code>
</block>


**Ausgabe**:
<block round box 70%>
<code>
5 APT | 2 Flatpak
</code>
</block>


**Funktionen**:
  * APT/pkcon-Updates zählen
  * Flatpak-Updates zählen
  * Kombinierte Ausgabe

===== Konfigurationsdateien =====

Nach erstmaligem Start und speichern. Davor in ''/usr/lib/guideos-conky''. So wird die Konfiguration vor Updates geschützt.

^ Datei ^ Zweck ^
| ''~/.conky/GuideOS.lua'' | Generierte Conky-Konfiguration |
| ''~/.conky/hwinfo.py'' | Hardware-Informations-Skript |
| ''~/.conky/check-update.py'' | Update-Check-Skript |
| ''~/.conky/images/'' | Logo-Verzeichnis |
| ''~/.config/autostart/guideos-conky-custom.desktop'' | Autostart-Eintrag |

===== Wichtige Hinweise =====

<WRAP round important 70%>
  * **Nerd Fonts erforderlich**: Für Icons müssen Nerd Fonts installiert sein
  * **Test-Modus**: Nutzen Sie den Test-Button vor dem Speichern
  * **Backup**: Bestehende Konfigurationen werden überschrieben
  * **Multi-Monitor**: Monitor-Nummer beginnt bei 0 (primärer Monitor)
  * **Intervalle**: Kurze Intervalle erhöhen CPU-Last
  * **Updates**: check-update.py benötigt sudo-Rechte für pkcon refresh
</WRAP>







===== Logo-Verzeichnisse =====

Das Tool sucht Logos in folgenden Verzeichnissen (Priorität):

  - ''./image/'' (relativ zum Configurator)
  - ''~/.conky/images/'' (Benutzer-Verzeichnis)
  - ''/usr/lib/guideos-conky/images/'' (System-Standard)

**Unterstützte Formate**: PNG, JPG, JPEG, SVG

===== Testmodus =====

Der Test-Button startet eine temporäre Conky-Instanz:
  - Konfiguration wird in ''/tmp/guideos-conky-test/'' gespeichert
  - Conky läuft im Vordergrund
  - "Test beenden"-Button stoppt die Vorschau
  - Änderungen werden nicht gespeichert

===== Problembehandlung =====

==== Conky startet nicht ====

<block round box 60%>
<code bash>
# Prüfen ob Conky installiert ist
which conky

# Konfiguration manuell testen
conky -c ~/.conky/GuideOS.lua

# Fehlerausgabe anzeigen
conky -c ~/.conky/GuideOS.lua -d
</code>
</block>


==== Schriftarten fehlen ====

<block round box 60%>
<code bash>
# Nerd Fonts prüfen
fc-list | grep "Nerd Font"

# Falls leer: Nerd Fonts installieren
</code>
</block>


==== Informationen werden nicht aktualisiert ====

<block round box 60%>
<code bash>
# Skripte ausführbar machen
chmod +x ~/.conky/hwinfo.py ~/.conky/check-update.py

# Python-Version prüfen
python3 --version

# Skripte manuell testen
python3 ~/.conky/hwinfo.py cpu
python3 ~/.conky/check-update.py
</code>
</block>


==== GPU-Informationen fehlen ====

<block round box 60%>
<code bash>
# lspci prüfen
lspci | grep -i vga

# Für NVIDIA GPU-Speicher
nvidia-smi

# Für AMD GPU-Speicher
cat /sys/class/drm/card0/device/mem_info_vram_total

# glxinfo installieren (für GPU-Speicher)
sudo apt install mesa-utils
</code>
</block>


==== Updates werden nicht gezählt ====

<block round box 60%>
<code bash>
# pkcon prüfen
which pkcon

# Manuell refreshen
sudo pkcon refresh

# Flatpak prüfen
flatpak remote-ls --updates
</code>
</block>


===== Lizenz =====

| **Entwickler** | KTT73 |
| **Komponenten** | Configurator, hwinfo.py, check-update.py |
| **Lizenz** | MIT |