How phantomslyrak/omarchy-saga-edition works
Omarchy Saga Edition is a set of four desktop-session components: boot visuals and recovery, a customized lock experience, an SDDM login theme, and a Hyprland desktop-reveal patch. The README identifies each component’s purpose, but does not describe a single end-to-end runtime pipeline between them. The map preserves those distinct product stages and their documented capabilities; source evidence shows the lock manager invoking renderer behavior and the lock-screen integration using shared handover logic. Other internal wiring is omitted where excerpts do not establish it.
Main entry points: lock-screen.py Lock host handover · SessionLockManager.cpp Lock manager · handover.py Plugin handover · Renderer.cpp Renderer implementation
Components 19
Boot and Recovery
- Plymouth visuals
components/sagaboot/theme/omarchy-boot.script - Boot layouts
components/sagaboot/source/BootArt.qml.in - Text fallback
components/sagaboot/deployment/patch/mkinitcpio.conf.d/zz-plymouth-fallback.conf - UKI install kit
components/sagaboot/deployment/install-kit/install.py - Install rollback
components/sagaboot/deployment/install-kit/rollback.py
Lock Experience
- Lock host handover
components/sagalock/integration/lock-screen.py - Plugin handover
components/sagalock/integration/handover.py - Lock designs
components/sagalock/lock-designs/SagaLock.qml - Telemetry model
components/sagalock/lock-designs/saga/TelemetryModel.js - Kazan weather
components/sagalock/lock-designs/saga/weather_kazan.py
Login Theme
- SDDM login theme
components/sagasddm/saga-sddm/Main.qml - Theme procedures
components/sagasddm/install.sh
Desktop Reveal
- Session controller
components/desktop-reveal/session/alternative/saga-session.py - Lock manager
components/desktop-reveal/source/src/managers/SessionLockManager.cpp - Renderer implementation
components/desktop-reveal/source/src/render/Renderer.cpp - Renderer API
components/desktop-reveal/source/src/render/Renderer.hpp - Reveal policy
components/desktop-reveal/source/src/render/SagaRevealPolicy.hpp
Other components
- Desktop user
- Weather service
Connections 2
- Lock host handover → Plugin handover: uses handover
components/sagalock/integration/lock-screen.py - Lock manager → Renderer implementation: invokes renderer
components/desktop-reveal/source/src/managers/SessionLockManager.cpp