nevaforget
96c94f030a
Replace env_logger file-based logging with systemd-journal-logger for consistency with moonlock and native journalctl integration. Add debug-level logging at all decision points: config loading, user/session detection, avatar resolution, locale detection, IPC messages, login flow, and persistence. No credentials are ever logged.
65 lines
2.9 KiB
Markdown
65 lines
2.9 KiB
Markdown
# Moongreet
|
|
|
|
**Name**: Selene (Mondgöttin — passend zu Moon-greet)
|
|
|
|
## Projekt
|
|
|
|
Moongreet ist ein greetd-Greeter für Wayland, gebaut mit Rust + gtk4-rs + gtk4-layer-shell.
|
|
Teil des Moonarch-Ökosystems.
|
|
|
|
## Tech-Stack
|
|
|
|
- Rust (Edition 2024), gtk4-rs 0.11, glib 0.22
|
|
- gtk4-layer-shell 0.8 für Wayland Layer Shell (TOP Layer)
|
|
- greetd IPC über Unix Domain Socket (length-prefixed JSON)
|
|
- `cargo test` für Unit-Tests
|
|
|
|
## Projektstruktur
|
|
|
|
- `src/` — Rust-Quellcode (main.rs, greeter.rs, ipc.rs, config.rs, users.rs, sessions.rs, i18n.rs, power.rs)
|
|
- `resources/` — GResource-Assets (style.css, wallpaper.jpg, default-avatar.svg)
|
|
- `config/` — Beispiel-Konfigurationsdateien für `/etc/moongreet/` und `/etc/greetd/`
|
|
- `pkg/` — PKGBUILD für Arch-Linux-Paketierung (`makepkg -sf`)
|
|
|
|
## Kommandos
|
|
|
|
```bash
|
|
# Tests ausführen
|
|
cargo test
|
|
|
|
# Release-Build
|
|
cargo build --release
|
|
|
|
# Greeter im Fenster starten (ohne greetd/Layer Shell)
|
|
MOONGREET_NO_LAYER_SHELL=1 ./target/release/moongreet
|
|
|
|
# Paket bauen und installieren
|
|
cd pkg && makepkg -sf && sudo pacman -U moongreet-git-<version>-x86_64.pkg.tar.zst
|
|
```
|
|
|
|
## Architektur
|
|
|
|
- `ipc.rs` — greetd Socket-Kommunikation (4-byte LE header + JSON)
|
|
- `users.rs` — Benutzer aus /etc/passwd, Avatare (AccountsService + ~/.face), Symlink-Rejection
|
|
- `sessions.rs` — Wayland/X11 Sessions aus .desktop Files
|
|
- `power.rs` — Reboot/Shutdown via loginctl
|
|
- `i18n.rs` — Locale-Erkennung (LANG / /etc/locale.conf) und String-Tabellen (DE/EN), alle UI- und Login-Fehlermeldungen
|
|
- `config.rs` — TOML-Config ([appearance] background, gtk-theme) + Wallpaper-Fallback
|
|
- `greeter.rs` — GTK4 UI (Overlay-Layout), Login-Flow via greetd IPC, Faillock-Warnung, Avatar-Cache, Last-User/Last-Session Persistence (0o600 Permissions)
|
|
- `main.rs` — Entry Point, GTK App, Layer Shell Setup, Multi-Monitor, systemd-journal-logger
|
|
- `resources/style.css` — Catppuccin-inspiriertes Theme
|
|
|
|
## Design Decisions
|
|
|
|
- **TOP Layer statt OVERLAY**: Greeter läuft unter greetd, nicht über Waybar
|
|
- **GResource-Bundle**: CSS, Wallpaper und Default-Avatar sind in die Binary kompiliert
|
|
- **Async Login**: `glib::spawn_future_local` + `gio::spawn_blocking` statt raw Threads
|
|
- **Socket-Cancellation**: `Arc<Mutex<Option<UnixStream>>>` + `AtomicBool` für saubere Abbrüche
|
|
- **Avatar-Cache**: `HashMap<String, gdk::Texture>` in `Rc<RefCell<GreeterState>>`
|
|
- **Symmetrie mit moonset**: Gleiche Patterns (i18n, config, users, power, GResource)
|
|
- **Session-Validierung**: Relative Pfade erlaubt (greetd löst PATH auf), nur `..`/Null-Bytes werden abgelehnt
|
|
- **GTK-Theme-Validierung**: Nur alphanumerisch + `_-+.` erlaubt, verhindert Path-Traversal über Config
|
|
- **Journal-Logging**: `systemd-journal-logger` statt File-Logging — `journalctl -t moongreet`
|
|
- **File Permissions**: Cache-Dateien 0o600
|
|
- **Testbare Persistence**: `save_*_to`/`load_*_from` Varianten mit konfigurierbarem Pfad für Unit-Tests
|