How dusklinux/dusky works
Dusky is an Arch/Hyprland desktop setup and utilities repository: users install the configuration, run a modular setup, then use its settings interfaces and standalone tools to manage their desktop and system. The README also describes an offline ISO installer and broad utilities; those are represented at their exact tree directories because their implementation was not sampled. The setup README names a shell entry point absent from the supplied tree, so the graph uses the listed Python orchestrator. Source-index references support the internal links shown; unsampled subsystem wiring is omitted.
Main entry points: main.py Settings TUI · main.rs Wallpaper app · ui.rs Wallpaper interface · lua.py Lua config engine
Components 29
Installation
- Setup conductor
user_scripts/arch_setup_scripts/orchestrator.py - System configuration
user_scripts/arch_setup_scripts/scripts - Offline installer
user_scripts/arch_iso_scripts/offline_iso - ISO generator
user_scripts/arch_iso_scripts/offline_iso/iso_maker/python/dusky_iso_generator.py
Desktop settings
- Settings TUI
user_scripts/dusky_tui/python/main/main.py - TUI frontend
user_scripts/dusky_tui/python/frontend/ui.py - Config types
user_scripts/dusky_tui/python/frontend/core_types.py - Lua config engine
user_scripts/dusky_tui/python/engines/lua.py - Monitor settings
user_scripts/dusky_tui/python/engines/monitor_engine.py - Waybar settings
user_scripts/dusky_tui/python/engines/waybar_engine.py - System config engines
user_scripts/dusky_tui/python/engines - Control Center
user_scripts/dusky_system/control_center/dusky_control_center.py
Wallpaper and theming
- Wallpaper app
user_scripts/images/dusky_papers/src/main.rs - Wallpaper interface
user_scripts/images/dusky_papers/src/ui.rs - Wallpaper scanner
user_scripts/images/dusky_papers/src/scanner.rs - Thumbnail cache
user_scripts/images/dusky_papers/src/cache.rs - Wallpaper theming
user_scripts/images/dusky_papers/src/theme.rs
System utilities
- Audio Studio
user_scripts/audio/dusky_audio_studio/dusky_audio_studio.py - PipeWire audio helper
user_scripts/audio/dusky_audio_studio/audio-helper/main.c - Snapshot manager
user_scripts/btrfs_snapshots/cc/dusky_snapshot_manager.py - Drive manager
user_scripts/drives/drive_manager/drive_manager.py - Local LLM panel
user_scripts/llm/llm_side_panal/dusky_llm.py - Music recognition
user_scripts/music/music_recognition.py - Network throttling
user_scripts/networking/network_throttle/src - Quota manager
user_scripts/networking/network_throttle/src/quota_manager.py - Quota database
user_scripts/networking/network_throttle/src/database.py - Backup manager
user_scripts/git/dusky_backup_manager.py - CPU core manager
user_scripts/performance/cpu/tui_dusky_core_manager.py
Other components
- Arch user
Connections 33
- Arch user → Setup conductor: runs setup
- Setup conductor → System configuration: runs modules
- Arch user → Offline installer: installs offline
- Offline installer → ISO generator: generates image
- Arch user → Settings TUI: configures desktop
- Settings TUI → TUI frontend: launches interface
user_scripts/dusky_tui/python/main/main.py - Settings TUI → Lua config engine: loads engine
user_scripts/dusky_tui/python/main/main.py - Settings TUI → Monitor settings: loads engine
user_scripts/dusky_tui/python/main/main.py - Settings TUI → Waybar settings: loads engine
user_scripts/dusky_tui/python/main/main.py - Settings TUI → System config engines: registers engines
user_scripts/dusky_tui/python/main/main.py - Lua config engine → Config types: uses types
user_scripts/dusky_tui/python/engines/lua.py - Monitor settings → Lua config engine: uses engine
user_scripts/dusky_tui/python/engines/monitor_engine.py - Waybar settings → Config types: uses types
user_scripts/dusky_tui/python/engines/waybar_engine.py - Arch user → Control Center: changes settings
- Arch user → Wallpaper app: chooses wallpaper
- Wallpaper app → Wallpaper interface: launches interface
user_scripts/images/dusky_papers/src/main.rs - Wallpaper app → Wallpaper scanner: scans images
user_scripts/images/dusky_papers/src/main.rs - Wallpaper app → Thumbnail cache: builds thumbnails
user_scripts/images/dusky_papers/src/main.rs - Wallpaper app → Wallpaper theming: uses theme
user_scripts/images/dusky_papers/src/main.rs - Wallpaper interface → Wallpaper scanner: uses scan results
user_scripts/images/dusky_papers/src/ui.rs - Wallpaper interface → Thumbnail cache: uses thumbnails
user_scripts/images/dusky_papers/src/ui.rs - Wallpaper interface → Wallpaper theming: uses theming
user_scripts/images/dusky_papers/src/ui.rs - Wallpaper scanner → Thumbnail cache: checks thumbnails
user_scripts/images/dusky_papers/src/scanner.rs - Arch user → Audio Studio: uses audio tools
- Audio Studio → PipeWire audio helper: delegates audio
- Arch user → Snapshot manager: manages snapshots
- Arch user → Drive manager: manages drives
- Arch user → Local LLM panel: uses local AI
- Arch user → Music recognition: identifies music
- Arch user → Network throttling: manages bandwidth
- Quota manager → Quota database: reads and updates
user_scripts/networking/network_throttle/src/quota_manager.py - Arch user → Backup manager: backs up files
- Arch user → CPU core manager: manages CPU cores