greetd-moongreet/CLAUDE.md
nevaforget 87c2e7d9c8 feat: initial Moongreet greeter implementation
greetd-Greeter für Wayland mit Python + GTK4 + gtk4-layer-shell.
Enthält IPC-Protokoll, User/Session-Erkennung, Power-Actions,
komplettes UI-Layout und 36 Tests (Unit + Integration).
2026-03-26 09:47:19 +01:00

1.1 KiB

Moongreet

Name: Selene (Mondgöttin — passend zu Moon-greet)

Projekt

Moongreet ist ein greetd-Greeter für Wayland, gebaut mit Python + GTK4 + gtk4-layer-shell. Teil des Moonarch-Ökosystems.

Tech-Stack

  • Python 3.11+, PyGObject (GTK 4.0)
  • gtk4-layer-shell für Wayland Layer Shell
  • greetd IPC über Unix Domain Socket (length-prefixed JSON)
  • pytest für Tests

Projektstruktur

  • src/moongreet/ — Quellcode
  • tests/ — pytest Tests
  • data/ — Assets (Icons, Default-Avatar)
  • config/ — Konfigurationsdateien

Kommandos

# Tests ausführen
uv run pytest tests/ -v

# Typ-Checks
uv run pyright src/

# Greeter starten (nur zum Testen, braucht normalerweise greetd)
uv run moongreet

Architektur

  • ipc.py — greetd Socket-Kommunikation (length-prefixed JSON)
  • users.py — Benutzer aus /etc/passwd, Avatare, GTK-Themes
  • sessions.py — Wayland/X11 Sessions aus .desktop Files
  • power.py — Reboot/Shutdown via loginctl
  • greeter.py — GTK4 UI (Overlay-Layout)
  • main.py — Entry Point, GTK App, Layer Shell Setup