Dies ist eine alte Version des Dokuments!

GuideOS Conky Configurator

Übersicht

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

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

Bedienung

Programm starten

guideos-conky-configurator

Oder aus dem Anwendungsmenü.

Konfiguration erstellen

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

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:

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

Funktionen:

Automatische GPU-Erkennung (NVIDIA, AMD, Intel)
Treiber-Versions-Erkennung
WAN IP-Ermittlung über externe API
Festplatten-Label-Unterstützung
Mehrsprachige Ausgabe (gettext)

check-update.py

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

Verwendung:

python3 check-update.py

Ausgabe:

5 APT | 2 Flatpak

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

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

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

# Prüfen ob Conky installiert ist
which conky
 
# Konfiguration manuell testen
conky -c ~/.conky/GuideOS.lua
 
# Fehlerausgabe anzeigen
conky -c ~/.conky/GuideOS.lua -d

Schriftarten fehlen

# Nerd Fonts prüfen
fc-list | grep "Nerd Font"
 
# Falls leer: Nerd Fonts installieren

Informationen werden nicht aktualisiert

# 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

GPU-Informationen fehlen

# 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

Updates werden nicht gezählt

# pkcon prüfen
which pkcon
 
# Manuell refreshen
sudo pkcon refresh
 
# Flatpak prüfen
flatpak remote-ls --updates

Lizenz

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

Dokumentation

Inhaltsverzeichnis