How grapes7000/arch-wm-install works
Arch WM Install provisions and maintains a customized Arch desktop, then provides its runtime shell, compositor configuration, terminal, and shared theming. The user chooses an installer profile and theme; the staged installer applies managed configuration and packages with resumable state and rollback. At runtime, Quickshell presents layout-driven surfaces and widgets, while Hyprland and terminal settings consume the shared theme contract. An optional desktop-profile manager audits and prepares alternate profiles. README capabilities inform unsampled branches; links are limited to documented behavior and sampled source, so exact internal wiring is not inferred.
Main entry points: runtime.py Stage runtime · theme-engine Generated theme targets · manager.py Profile planning and activation · shell.qml Shell entry and surfaces
Components 24
Installation and Recovery
- Installer CLI
install.sh - Stage runtime
installer/runtime.py - Installer entry
installer/entry.py - Run state and backups
installer/state.py - Package manifests
manifests
Theme Engine
- Theme commands
modules/theme-engine/bin/theme - Theme generators
modules/theme-engine/bin/theme_components.py - Theme catalog and schema
modules/theme-engine/schema - Generated theme targets
modules/theme-engine
Quickshell Platform
- Shell entry and surfaces
modules/shell/shell.qml - Shell registries and context
modules/shell/core - Surface layouts
modules/shell/layouts - Portable widgets
modules/shell/widgets - System services
modules/shell/services
Desktop Runtime
- Hyprland configuration
modules/hyprland/config - Terminal configuration
modules/terminal - Login configuration
modules/login
Profile Management
- Profile manager CLI
desktop_manager/cli.py - Profile planning and activation
desktop_manager/manager.py - Profile safety scanner
desktop_manager/scanner.py - Optional Codex review
desktop_manager/codex_review.py
Other components
- Desktop user
- Arch Linux system
- Theme upstream
Connections 24
- Desktop user → Installer CLI: selects profile
- Installer CLI → Installer entry: dispatches
- Installer entry → Stage runtime: configures stages
- Stage runtime → Run state and backups: records backups
- Stage runtime → Package manifests: reads packages
- Stage runtime → Arch Linux system: installs configuration
- Theme upstream → Theme catalog and schema: provides catalog
- Theme commands → Theme catalog and schema: reads themes
- Theme commands → Theme generators: generates targets
- Theme generators → Generated theme targets: writes targets
- Stage runtime → Theme commands: installs theme engine
- Generated theme targets → Hyprland configuration: supplies theme settings
- Generated theme targets → Shell entry and surfaces: supplies theme settings
- Generated theme targets → Terminal configuration: supplies theme settings
- Shell entry and surfaces → Shell registries and context: uses registries
- Shell entry and surfaces → Surface layouts: loads layouts
- Shell registries and context → Portable widgets: resolves widgets
- Portable widgets → System services: reads service state
- Desktop user → Shell entry and surfaces: interacts with desktop
- Desktop user → Profile manager CLI: requests profile action
- Profile manager CLI → Profile planning and activation: dispatches command
- Profile planning and activation → Profile safety scanner: audits profile
- Profile planning and activation → Optional Codex review: requests review
- Profile planning and activation → Run state and backups: tracks managed changes