# dusklinux/dusky architecture

> Architecture diagram of the GitHub repository dusklinux/dusky, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dusklinux/dusky
- Repository: https://github.com/dusklinux/dusky

## Overview

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: [`user_scripts/dusky_tui/python/main/main.py`](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/main/main.py) (Settings TUI), [`user_scripts/images/dusky_papers/src/main.rs`](https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/main.rs) (Wallpaper app), [`user_scripts/images/dusky_papers/src/ui.rs`](https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/ui.rs) (Wallpaper interface), [`user_scripts/dusky_tui/python/engines/lua.py`](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/engines/lua.py) (Lua config engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation"]
  node_setup["Setup conductor<br/>[orchestrator.py]"]
  node_setup_scripts["System configuration"]
  node_iso["Offline installer"]
  node_iso_generator["ISO generator"]
end

subgraph group_settings["Desktop settings"]
  node_tui["Settings TUI<br/>[main.py]"]
  node_frontend["TUI frontend<br/>[ui.py]"]
  node_config_types["Config types<br/>[core_types.py]"]
  node_lua_engine["Lua config engine<br/>[lua.py]"]
  node_monitor_engine["Monitor settings<br/>[monitor_engine.py]"]
  node_waybar_engine["Waybar settings<br/>[waybar_engine.py]"]
  node_other_engines["System config engines"]
  node_control_center["Control Center"]
end

subgraph group_wallpapers["Wallpaper and theming"]
  node_papers["Wallpaper app<br/>[main.rs]"]
  node_papers_ui["Wallpaper interface<br/>[ui.rs]"]
  node_scanner["Wallpaper scanner<br/>[scanner.rs]"]
  node_cache[("Thumbnail cache<br/>[cache.rs]")]
  node_theme["Wallpaper theming<br/>[theme.rs]"]
end

subgraph group_utilities["System utilities"]
  node_audio_studio["Audio Studio"]
  node_audio_helper["PipeWire audio helper<br/>[main.c]"]
  node_snapshot_manager["Snapshot manager"]
  node_drive_manager["Drive manager<br/>[drive_manager.py]"]
  node_llm_panel["Local LLM panel<br/>[dusky_llm.py]"]
  node_music_recognition["Music recognition"]
  node_network_throttle["Network throttling"]
  node_quota_manager["Quota manager<br/>[quota_manager.py]"]
  node_quota_database[("Quota database<br/>[database.py]")]
  node_backup_manager["Backup manager"]
  node_core_manager["CPU core manager"]
end

node_user(("Arch user"))

node_user -->|"runs setup"| node_setup
node_setup -->|"runs modules"| node_setup_scripts
node_user -.->|"installs offline"| node_iso
node_iso -.->|"generates image"| node_iso_generator
node_user -.->|"configures desktop"| node_tui
node_tui -->|"launches interface"| node_frontend
node_tui -->|"loads engine"| node_lua_engine
node_tui -->|"loads engine"| node_monitor_engine
node_tui -->|"loads engine"| node_waybar_engine
node_tui -->|"registers engines"| node_other_engines
node_lua_engine -->|"uses types"| node_config_types
node_monitor_engine -->|"uses engine"| node_lua_engine
node_waybar_engine -->|"uses types"| node_config_types
node_user -->|"changes settings"| node_control_center
node_user -.->|"chooses wallpaper"| node_papers
node_papers -->|"launches interface"| node_papers_ui
node_papers -->|"scans images"| node_scanner
node_papers -->|"builds thumbnails"| node_cache
node_papers -->|"uses theme"| node_theme
node_papers_ui -->|"uses scan results"| node_scanner
node_papers_ui -->|"uses thumbnails"| node_cache
node_papers_ui -->|"uses theming"| node_theme
node_scanner -->|"checks thumbnails"| node_cache
node_user -.->|"uses audio tools"| node_audio_studio
node_audio_studio -.->|"delegates audio"| node_audio_helper
node_user -.->|"manages snapshots"| node_snapshot_manager
node_user -.->|"manages drives"| node_drive_manager
node_user -->|"uses local AI"| node_llm_panel
node_user -->|"identifies music"| node_music_recognition
node_user -.->|"manages bandwidth"| node_network_throttle
node_quota_manager -->|"reads and updates"| node_quota_database
node_user -.->|"backs up files"| node_backup_manager
node_user -.->|"manages CPU cores"| node_core_manager

click node_setup "https://github.com/dusklinux/dusky/blob/main/user_scripts/arch_setup_scripts/orchestrator.py"
click node_setup_scripts "https://github.com/dusklinux/dusky/tree/main/user_scripts/arch_setup_scripts/scripts"
click node_iso "https://github.com/dusklinux/dusky/tree/main/user_scripts/arch_iso_scripts/offline_iso"
click node_iso_generator "https://github.com/dusklinux/dusky/blob/main/user_scripts/arch_iso_scripts/offline_iso/iso_maker/python/dusky_iso_generator.py"
click node_tui "https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/main/main.py"
click node_frontend "https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/frontend/ui.py"
click node_config_types "https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/frontend/core_types.py"
click node_lua_engine "https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/engines/lua.py"
click node_monitor_engine "https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/engines/monitor_engine.py"
click node_waybar_engine "https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/engines/waybar_engine.py"
click node_other_engines "https://github.com/dusklinux/dusky/tree/main/user_scripts/dusky_tui/python/engines"
click node_control_center "https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_system/control_center/dusky_control_center.py"
click node_papers "https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/main.rs"
click node_papers_ui "https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/ui.rs"
click node_scanner "https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/scanner.rs"
click node_cache "https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/cache.rs"
click node_theme "https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/theme.rs"
click node_audio_studio "https://github.com/dusklinux/dusky/blob/main/user_scripts/audio/dusky_audio_studio/dusky_audio_studio.py"
click node_audio_helper "https://github.com/dusklinux/dusky/blob/main/user_scripts/audio/dusky_audio_studio/audio-helper/main.c"
click node_snapshot_manager "https://github.com/dusklinux/dusky/blob/main/user_scripts/btrfs_snapshots/cc/dusky_snapshot_manager.py"
click node_drive_manager "https://github.com/dusklinux/dusky/blob/main/user_scripts/drives/drive_manager/drive_manager.py"
click node_llm_panel "https://github.com/dusklinux/dusky/blob/main/user_scripts/llm/llm_side_panal/dusky_llm.py"
click node_music_recognition "https://github.com/dusklinux/dusky/blob/main/user_scripts/music/music_recognition.py"
click node_network_throttle "https://github.com/dusklinux/dusky/tree/main/user_scripts/networking/network_throttle/src"
click node_quota_manager "https://github.com/dusklinux/dusky/blob/main/user_scripts/networking/network_throttle/src/quota_manager.py"
click node_quota_database "https://github.com/dusklinux/dusky/blob/main/user_scripts/networking/network_throttle/src/database.py"
click node_backup_manager "https://github.com/dusklinux/dusky/blob/main/user_scripts/git/dusky_backup_manager.py"
click node_core_manager "https://github.com/dusklinux/dusky/blob/main/user_scripts/performance/cpu/tui_dusky_core_manager.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_setup,node_setup_scripts,node_iso,node_iso_generator,node_user toneBlue
class node_tui,node_frontend,node_config_types,node_lua_engine,node_monitor_engine,node_waybar_engine,node_other_engines,node_control_center toneAmber
class node_papers,node_papers_ui,node_scanner,node_cache,node_theme toneMint
class node_audio_studio,node_audio_helper,node_snapshot_manager,node_drive_manager,node_llm_panel,node_music_recognition,node_network_throttle,node_quota_manager,node_quota_database,node_backup_manager,node_core_manager toneRose
```

## Components

### Installation

- [Setup conductor](https://github.com/dusklinux/dusky/blob/main/user_scripts/arch_setup_scripts/orchestrator.py): `user_scripts/arch_setup_scripts/orchestrator.py`
- [System configuration](https://github.com/dusklinux/dusky/tree/main/user_scripts/arch_setup_scripts/scripts): `user_scripts/arch_setup_scripts/scripts`
- [Offline installer](https://github.com/dusklinux/dusky/tree/main/user_scripts/arch_iso_scripts/offline_iso): `user_scripts/arch_iso_scripts/offline_iso`
- [ISO generator](https://github.com/dusklinux/dusky/blob/main/user_scripts/arch_iso_scripts/offline_iso/iso_maker/python/dusky_iso_generator.py): `user_scripts/arch_iso_scripts/offline_iso/iso_maker/python/dusky_iso_generator.py`

### Desktop settings

- [Settings TUI](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/main/main.py): `user_scripts/dusky_tui/python/main/main.py`
- [TUI frontend](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/frontend/ui.py): `user_scripts/dusky_tui/python/frontend/ui.py`
- [Config types](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/frontend/core_types.py): `user_scripts/dusky_tui/python/frontend/core_types.py`
- [Lua config engine](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/engines/lua.py): `user_scripts/dusky_tui/python/engines/lua.py`
- [Monitor settings](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/engines/monitor_engine.py): `user_scripts/dusky_tui/python/engines/monitor_engine.py`
- [Waybar settings](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_tui/python/engines/waybar_engine.py): `user_scripts/dusky_tui/python/engines/waybar_engine.py`
- [System config engines](https://github.com/dusklinux/dusky/tree/main/user_scripts/dusky_tui/python/engines): `user_scripts/dusky_tui/python/engines`
- [Control Center](https://github.com/dusklinux/dusky/blob/main/user_scripts/dusky_system/control_center/dusky_control_center.py): `user_scripts/dusky_system/control_center/dusky_control_center.py`

### Wallpaper and theming

- [Wallpaper app](https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/main.rs): `user_scripts/images/dusky_papers/src/main.rs`
- [Wallpaper interface](https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/ui.rs): `user_scripts/images/dusky_papers/src/ui.rs`
- [Wallpaper scanner](https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/scanner.rs): `user_scripts/images/dusky_papers/src/scanner.rs`
- [Thumbnail cache](https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/cache.rs): `user_scripts/images/dusky_papers/src/cache.rs`
- [Wallpaper theming](https://github.com/dusklinux/dusky/blob/main/user_scripts/images/dusky_papers/src/theme.rs): `user_scripts/images/dusky_papers/src/theme.rs`

### System utilities

- [Audio Studio](https://github.com/dusklinux/dusky/blob/main/user_scripts/audio/dusky_audio_studio/dusky_audio_studio.py): `user_scripts/audio/dusky_audio_studio/dusky_audio_studio.py`
- [PipeWire audio helper](https://github.com/dusklinux/dusky/blob/main/user_scripts/audio/dusky_audio_studio/audio-helper/main.c): `user_scripts/audio/dusky_audio_studio/audio-helper/main.c`
- [Snapshot manager](https://github.com/dusklinux/dusky/blob/main/user_scripts/btrfs_snapshots/cc/dusky_snapshot_manager.py): `user_scripts/btrfs_snapshots/cc/dusky_snapshot_manager.py`
- [Drive manager](https://github.com/dusklinux/dusky/blob/main/user_scripts/drives/drive_manager/drive_manager.py): `user_scripts/drives/drive_manager/drive_manager.py`
- [Local LLM panel](https://github.com/dusklinux/dusky/blob/main/user_scripts/llm/llm_side_panal/dusky_llm.py): `user_scripts/llm/llm_side_panal/dusky_llm.py`
- [Music recognition](https://github.com/dusklinux/dusky/blob/main/user_scripts/music/music_recognition.py): `user_scripts/music/music_recognition.py`
- [Network throttling](https://github.com/dusklinux/dusky/tree/main/user_scripts/networking/network_throttle/src): `user_scripts/networking/network_throttle/src`
- [Quota manager](https://github.com/dusklinux/dusky/blob/main/user_scripts/networking/network_throttle/src/quota_manager.py): `user_scripts/networking/network_throttle/src/quota_manager.py`
- [Quota database](https://github.com/dusklinux/dusky/blob/main/user_scripts/networking/network_throttle/src/database.py): `user_scripts/networking/network_throttle/src/database.py`
- [Backup manager](https://github.com/dusklinux/dusky/blob/main/user_scripts/git/dusky_backup_manager.py): `user_scripts/git/dusky_backup_manager.py`
- [CPU core manager](https://github.com/dusklinux/dusky/blob/main/user_scripts/performance/cpu/tui_dusky_core_manager.py): `user_scripts/performance/cpu/tui_dusky_core_manager.py`

### Other components

- **Arch user**

## Connections

- 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 (evidence: `user_scripts/dusky_tui/python/main/main.py`)
- Settings TUI → Lua config engine: loads engine (evidence: `user_scripts/dusky_tui/python/main/main.py`)
- Settings TUI → Monitor settings: loads engine (evidence: `user_scripts/dusky_tui/python/main/main.py`)
- Settings TUI → Waybar settings: loads engine (evidence: `user_scripts/dusky_tui/python/main/main.py`)
- Settings TUI → System config engines: registers engines (evidence: `user_scripts/dusky_tui/python/main/main.py`)
- Lua config engine → Config types: uses types (evidence: `user_scripts/dusky_tui/python/engines/lua.py`)
- Monitor settings → Lua config engine: uses engine (evidence: `user_scripts/dusky_tui/python/engines/monitor_engine.py`)
- Waybar settings → Config types: uses types (evidence: `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 (evidence: `user_scripts/images/dusky_papers/src/main.rs`)
- Wallpaper app → Wallpaper scanner: scans images (evidence: `user_scripts/images/dusky_papers/src/main.rs`)
- Wallpaper app → Thumbnail cache: builds thumbnails (evidence: `user_scripts/images/dusky_papers/src/main.rs`)
- Wallpaper app → Wallpaper theming: uses theme (evidence: `user_scripts/images/dusky_papers/src/main.rs`)
- Wallpaper interface → Wallpaper scanner: uses scan results (evidence: `user_scripts/images/dusky_papers/src/ui.rs`)
- Wallpaper interface → Thumbnail cache: uses thumbnails (evidence: `user_scripts/images/dusky_papers/src/ui.rs`)
- Wallpaper interface → Wallpaper theming: uses theming (evidence: `user_scripts/images/dusky_papers/src/ui.rs`)
- Wallpaper scanner → Thumbnail cache: checks thumbnails (evidence: `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 (evidence: `user_scripts/networking/network_throttle/src/quota_manager.py`)
- Arch user → Backup manager: backs up files
- Arch user → CPU core manager: manages CPU cores
