How mmdos32/simorgh works
Simorgh is an Arch Linux desktop distribution delivered either as a bootable installer ISO or as an installer for an existing Arch system. The main workflows begin with the user choosing one of those routes, proceed through installation and configuration, and end at a Hyprland desktop. Its major runtime capabilities include coordinated desktop configuration and themes, application/menu utilities, and system controls. The graph uses README-documented relationships; source excerpts do not cover the installer scripts or desktop configuration wiring, so those internal links are omitted where documentation does not establish them.
Main entry points: hypr Hyprland desktop · install.sh Arch installer · calamares Calamares installer · bootstrap.sh Bootstrap entry
Components 24
Installation
- Bootstrap entry
bootstrap.sh - Arch installer
install.sh - Package selections
packages - Live ISO profile
iso - Calamares installer
iso/airootfs/etc/calamares - Live setup
iso/airootfs/usr/local/lib/simorgh-live-setup.sh - Target installer
iso/airootfs/usr/local/bin/simorgh-target-install
Desktop
- Hyprland desktop
config/hypr - Waybar
config/waybar - Rofi launcher
config/rofi - Notifications
config/swaync - SDDM login
config/sddm - Shell environment
config/zsh
Themes and settings
- Theme switcher
bin/simorgh-theme - Theme definitions
themes - Desktop settings
config
User utilities
- Simorgh menu
bin/simorgh-menu - Power controls
bin/simorgh-power - Self updater
bin/simorgh-update - Keybind guide
bin/simorgh-keybinds - Screen recording
bin/simorgh-record
Other components
- User
- Arch system
- Bootable USB
Connections 21
- User → Bootstrap entry: runs installer
README.md - Bootstrap entry → Arch installer: starts
README.md - Arch system → Arch installer: hosts install
README.md - Arch installer → Package selections: installs selections
README.md - User → Bootable USB: boots
README.md - Bootable USB → Live ISO profile: starts live system
README.md - Live ISO profile → Calamares installer: opens installer
README.md - Calamares installer → Target installer: installs system
README.md - Calamares installer → Live setup: configures live session
- User → Calamares installer: chooses install options
README.md - Arch installer → Hyprland desktop: deploys desktop
README.md - User → Theme switcher: switches theme
README.md - Theme switcher → Theme definitions: applies theme
README.md - Hyprland desktop → Waybar: shows top bar
README.md - Hyprland desktop → Rofi launcher: opens launcher
README.md - Hyprland desktop → Notifications: opens notifications
README.md - User → Simorgh menu: opens menu
README.md - Simorgh menu → Self updater: offers updates
README.md - User → Power controls: opens power menu
README.md - User → Keybind guide: opens guide
README.md - User → Screen recording: starts recording
README.md