Sonnenuhr

Zweck

Sonnenuhr ist ein lokaler Python-Daemon fuer adaptive Monitorhelligkeit und Farbtemperatur nach Sonnenstand. Der Daemon laeuft mit einer periodischen Update-Schleife, berechnet Zielwerte aus Standort und Tagesphase und nimmt Steuerkommandos ueber einen Unix-Socket an. Optional kann auch ein COSMIC-Theme-Wechsel beruecksichtigt werden.

Voraussetzungen

• Python 3 mit der Abhaengigkeit aus requirements.txt: astral>=3.2.
• Fuer echte Display-Aenderungen nutzt das Projekt sichtbare lokale Tools/Pfade wie ddcutil, brightnessctl, gammastep und COSMIC-Theme-Kommandos.
• Die Default-Konfiguration liegt in config/sonnenuhr.json.
• User-Overrides werden standardmaessig aus ~/.config/sonnenuhr/config.json geladen; alternativ kann SONNENUHR_CONFIG gesetzt werden.

Quickstart

./.venv/bin/python sonnenuhr.py

Der vorhandene Systemd-User-Service services/sonnenuhr.service startet in diesem Checkout:

/home/smlflg/Projekte/Sonnenuhr/.venv/bin/python3 /home/smlflg/Projekte/Sonnenuhr/sonnenuhr.py

Die CLI spricht den laufenden Daemon ueber /tmp/sonnenuhr.sock an:

./sonnenuhr-ctl status

CLI

Sichtbare Kommandos aus sonnenuhr-ctl:

• status: aktuellen Zustand anzeigen.
• set <brightness>: Helligkeit 0-100 setzen und Override-Modus verwenden.
• color <kelvin>: Farbtemperatur 2700-6500K setzen und Override-Modus verwenden.
• override <min>: aktuelle Werte fuer N Minuten halten.
• auto: zur Automatik zurueckkehren.
• disable: Daemon pausieren.
• enable: Daemon fortsetzen.
• theme <mode>: Theme auf dark, light oder auto setzen.
• set-display <name> <brightness>: persistente Zielhelligkeit fuer ein Display setzen.
• set-display-offset <name> <offset>: persistenten Helligkeits-Offset fuer ein Display setzen.
• set-display-color <name> <kelvin>: Display-Farbwert 2700-6500K setzen.
• set-display-enabled <name> <on|off>: Display aktivieren oder deaktivieren.

Runtime-Pfade

• Socket: /tmp/sonnenuhr.sock
• State: /tmp/sonnenuhr-state.json
• State-Tempdatei: /tmp/.sonnenuhr-state.tmp
• Log: /tmp/sonnenuhr.log
• Lock: /tmp/sonnenuhr.lock
• Default-Config: config/sonnenuhr.json
• User-Config: ~/.config/sonnenuhr/config.json oder der Pfad aus SONNENUHR_CONFIG

Tests

./.venv/bin/python -m pytest -q

Hinweise

• Die Beispielkonfiguration nutzt Standort 51.05, 13.74 mit Zeitzone Europe/Berlin.
• Die Defaultwerte enthalten day_max: 100, night_min: 10, day_kelvin: 6500, night_kelvin: 5000, override_duration_minutes: 120 und update_interval_seconds: 30.
• Hardware- und Desktop-Verhalten haengt von der lokalen Umgebung und den genannten externen Tools ab.