Files
moonarch/CLAUDE.md
T
nevaforget 952776c4f9
Update PKGBUILD version / update-pkgver (push) Successful in 2s
batsaver: switch to pkexec helper, drop broken udev permission hack
The wheel-write-via-udev approach for charge_control_end_threshold has
been broken since 2026-04-08: the audit-remediation commit added
ACTION=="add" to the rule, but the threshold attribute doesn't exist
yet at the add event on Lenovo, so chmod fails silently and permissions
are never set. moonarch-batsaver-toggle has been returning Permission
denied since.

Replace the udev-rule approach with a pkexec helper:

  defaults/bin/moonarch-batsaver-apply    privileged: validate + write
  defaults/bin/moonarch-batsaver-toggle   user: read sysfs, dispatch via pkexec
  defaults/bin/moonarch-batsaver-restore  boot-time root restore (extracted
                                          from inline ExecStart for clarity)

Default Standard-pkexec prompt — password cached per session for the
~5min auth window; no polkit no-password rule, no privilege escalation
surface from misvalidated input. Same pattern Battery-Health-Charging
GNOME extension uses.

The boot-time restore service now skips the kernel write when the
sysfs value already matches the saved state (Lenovo drivers reject
same-value writes with EINVAL).

DECISIONS.md documents the failure analysis and trade-offs.
CLAUDE.md updated to describe the new flow.
moonarch-doctor: udev-effectiveness check removed.
2026-05-04 12:17:31 +02:00

4.3 KiB

Moonarch

Reproduzierbares Arch-Linux-Setup basierend auf archinstall + Post-Install-Automatisierung.

Projektstruktur

  • config/ — archinstall-Konfiguration (inkl. custom-commands die das Repo nach /opt/moonarch klonen, root-owned)
  • scripts/ — Post-Install- und Helper-Scripts
  • packages/ — Paketlisten (offiziell + AUR), getrennt gepflegt
  • defaults/ — XDG-Configs, Shell-Config, Helper-Binaries, systemd Services, udev-Regeln, greetd/moongreet-Config, Wallpaper

Battery Conservation Mode

Laptops mit charge_control_end_threshold-Support (ThinkPad, Framework, etc.) erhalten einen Waybar-Toggle:

  • Klick auf das Battery-Modul schaltet zwischen 80% und 100% Ladegrenze um
  • Bei aktiver Conservation erscheint ein ♥-Icon neben der Battery-Anzeige
  • Zustand wird in /var/lib/moonarch/batsaver-threshold persistiert und beim Boot via systemd-Service (moonarch-batsaver-restore) wiederhergestellt
  • Toggle-Flow: moonarch-batsaver-toggle (User-Script) liest sysfs, entscheidet 80↔100, ruft pkexec /usr/bin/moonarch-batsaver-apply $NEW für den privilegierten sysfs+state-Schreibschritt. Standard-pkexec-Prompt (Passwort einmal pro Session-Cache)
  • Auf Desktops ohne Battery-Support versteckt sich das Feature komplett

Nightlight (Blaufilter)

Waybar-Toggle für wlsunset (Wayland-nativer Blaufilter), persistenter Zustand via systemd:

  • wlsunset.service (systemd User-Service) mit After=kanshi.service — startet erst wenn alle Outputs konfiguriert sind
  • Klick auf das Nightlight-Modul in group/brightness toggled wlsunset an/aus (enable --now / disable --now)
  • Zustand überlebt Reboots (enabled/disabled bleibt bestehen)
  • Aktiver Zustand zeigt 󰌵 in Catppuccin Yellow, inaktiv 󰌶 in Standard-Textfarbe
  • Signal SIGRTMIN+11 für sofortiges Waybar-Refresh
  • Scripts: moonarch-nightlight (Toggle), moonarch-waybar-nightlight (Status-JSON)

Waybar Config Merger (moonarch-waybar)

Waybar wird über moonarch-waybar gestartet (nicht direkt). Der Wrapper merged eine optionale User-Config (~/.config/waybar/userconfig) mit der System-Config (/etc/xdg/waybar/config):

  • prepend/append-Keys in der userconfig erweitern modules-left/modules-center/modules-right Arrays
  • Alle anderen Top-Level-Keys werden als Modul-Definitionen per Object-Merge eingefügt
  • Merge wird nur bei Änderungen ausgeführt (Timestamp-Vergleich)
  • Bei Fehler: notify-send + logger, Waybar startet mit System-Config
  • Generiert ~/.config/waybar/style.css mit @import der System-Styles falls nicht vorhanden
  • Benötigt jq (in PKGBUILD als Dependency)
  • System-Config muss valides JSON sein (kein JSONC)

mpv + ModernZ OSC

Videoplayer ist mpv mit ModernZ als OSC, Thumbnails via thumbfast:

  • mpv-modernz-git liefert modernz.lua + Font + Default-Config nach /etc/mpv/
  • mpv-thumbfast-git liefert thumbfast.lua nach /etc/mpv/scripts/ (wird von ModernZ automatisch erkannt)
  • defaults/etc/mpv/mpv.conf wird von moonarch-git direkt nach /etc/mpv/mpv.conf installiert (owned)
  • Stock-OSC + Titelleiste deaktiviert, autofit-larger=80%x80% cappt übergroße Fenster
  • ModernZ-Overrides per script-opts-append in mpv.conf: Orange-Akzent → Catppuccin Lavender (#b4befe), OSC-Scale 0.75, window_title_font_size=18, ontop_button=no
  • Wichtig: mpv behandelt # als Mid-Line-Kommentar; Hex-Farben müssen gequotet werden: script-opts-append="modernz-seekbarfg_color=#b4befe" (nicht \#, das escaped nur und verschluckt den Rest)
  • Niri öffnet mpv floating (window-rule in defaults/xdg/niri/config.kdl)

System Health Check (moonarch-doctor / moondoc)

Diagnose-Script das den Systemzustand gegen moonarch-Defaults prüft:

  • Pakete (official.txt + aur.txt installiert? Orphans?)
  • System-Services (NetworkManager, bluetooth, greetd, ufw, auto-cpufreq, etc.)
  • User-Services (kanshi, wlsunset, stasis, walker, nautilus, cliphist-text, cliphist-image)
  • Config-Dateien (SHA256-Vergleich deployed vs. moonarch-Default)
  • Helper-Scripts + Symlinks (moonup, moondoc)
  • System-Config (UFW, Pacman/Paru Repos, Default Shell)
  • Verzeichnisse + Permissions

Konventionen

  • Paketlisten sind einfache Textdateien, ein Paket pro Zeile, Kommentare mit #
  • Shell-Scripts müssen POSIX-kompatibel oder explizit bash/zsh sein
  • Alle Pfade im archinstall-Config relativ zum Installationsziel