# linuxbeginnings/hyprland-dots architecture

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

- Interactive diagram: https://gitdiagram.com/linuxbeginnings/hyprland-dots
- Repository: https://github.com/linuxbeginnings/hyprland-dots

## Overview

KooL’s Hyprland Dotfiles is a preconfigured Linux desktop environment, not a package installer: users apply the configs, then interact with Hyprland and its shell utilities. The principal documented workflow is choosing a monitor layout, saving it in the user monitor configuration, and having the Hyprland Lua configuration load it across reloads and restarts. The repository also provides an overview/search shell, themed desktop components, and utility scripts. Relationships beyond those documented in the README are omitted because the sampled sources do not establish their wiring.

Main entry points: [`config/hypr/scripts/DisplayProfileMenu.sh`](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/scripts/DisplayProfileMenu.sh) (Display Controls), [`config/hypr/UserConfigs/monitors.lua`](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/UserConfigs/monitors.lua) (Monitor Layout), [`config/hypr/Monitor_Profiles`](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/Monitor_Profiles) (Monitor Profiles), [`config/hypr/hyprland.lua`](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/hyprland.lua) (Hyprland Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Configuration"]
  node_hyprland["Hyprland Config<br/>[hyprland.lua]"]
  node_userconfig["User Settings"]
  node_animations["Animation Profiles"]
  node_lock["Lock Screen<br/>[hyprlock.conf]"]
end

subgraph group_display["Display Layouts"]
  node_monitorcfg["Monitor Layout<br/>[monitors.lua]"]
  node_profiles["Monitor Profiles"]
  node_displaymenu["Display Controls"]
  node_profiletools["Profile Tools"]
end

subgraph group_shell["Shell Interfaces"]
  node_ags["AGS Shell<br/>[config.js]"]
  node_overview["Overview Search<br/>[windowcontent.js]"]
  node_overviewview["Window Overview"]
  node_quickshell["Quickshell"]
  node_waybar["Waybar"]
end

subgraph group_utilities["Desktop Utilities"]
  node_rofi["Rofi Menus"]
  node_scripts["Hyprland Scripts"]
  node_weather["Weather Utility<br/>[Weather.py]"]
  node_themeconfigs["Application Themes"]
end

node_user(("Desktop User"))

node_user -->|"opens with shortcut"| node_displaymenu
node_user -->|"opens from settings"| node_displaymenu
node_displaymenu -->|"writes layout"| node_monitorcfg
node_hyprland -->|"loads configuration"| node_monitorcfg
node_displaymenu -->|"lists legacy layouts"| node_profiles
node_profiletools -->|"imports layouts"| node_profiles
node_user -.->|"uses desktop shell"| node_overview
node_user -.->|"uses desktop shell"| node_waybar
node_user -.->|"opens menus"| node_rofi
node_user -.->|"uses shell"| node_quickshell

click node_hyprland "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/hyprland.lua"
click node_userconfig "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/UserConfigs"
click node_animations "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/animations"
click node_lock "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/hyprlock.conf"
click node_monitorcfg "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/UserConfigs/monitors.lua"
click node_profiles "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/Monitor_Profiles"
click node_displaymenu "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/scripts/DisplayProfileMenu.sh"
click node_profiletools "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/scripts/DisplayProfileSetup.sh"
click node_ags "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/ags/config.js"
click node_overview "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/ags/modules/overview/windowcontent.js"
click node_overviewview "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/ags/modules/overview/overview_hyprland.js"
click node_quickshell "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/quickshell"
click node_waybar "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/waybar"
click node_rofi "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/rofi"
click node_scripts "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/scripts"
click node_weather "https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/UserScripts/Weather.py"
click node_themeconfigs "https://github.com/linuxbeginnings/hyprland-dots/tree/main/config"

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_hyprland,node_userconfig,node_animations,node_lock,node_user toneBlue
class node_monitorcfg,node_profiles,node_displaymenu,node_profiletools toneAmber
class node_ags,node_overview,node_overviewview,node_quickshell,node_waybar toneMint
class node_rofi,node_scripts,node_weather,node_themeconfigs toneRose
```

## Components

### Desktop Configuration

- [Hyprland Config](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/hyprland.lua): `config/hypr/hyprland.lua`
- [User Settings](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/UserConfigs): `config/hypr/UserConfigs`
- [Animation Profiles](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/animations): `config/hypr/animations`
- [Lock Screen](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/hyprlock.conf): `config/hypr/hyprlock.conf`

### Display Layouts

- [Monitor Layout](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/UserConfigs/monitors.lua): `config/hypr/UserConfigs/monitors.lua`
- [Monitor Profiles](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/Monitor_Profiles): `config/hypr/Monitor_Profiles`
- [Display Controls](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/scripts/DisplayProfileMenu.sh): `config/hypr/scripts/DisplayProfileMenu.sh`
- [Profile Tools](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/scripts/DisplayProfileSetup.sh): `config/hypr/scripts/DisplayProfileSetup.sh`

### Shell Interfaces

- [AGS Shell](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/ags/config.js): `config/ags/config.js`
- [Overview Search](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/ags/modules/overview/windowcontent.js): `config/ags/modules/overview/windowcontent.js`
- [Window Overview](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/ags/modules/overview/overview_hyprland.js): `config/ags/modules/overview/overview_hyprland.js`
- [Quickshell](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/quickshell): `config/quickshell`
- [Waybar](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/waybar): `config/hypr/waybar`

### Desktop Utilities

- [Rofi Menus](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/rofi): `config/hypr/rofi`
- [Hyprland Scripts](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config/hypr/scripts): `config/hypr/scripts`
- [Weather Utility](https://github.com/linuxbeginnings/hyprland-dots/blob/main/config/hypr/UserScripts/Weather.py): `config/hypr/UserScripts/Weather.py`
- [Application Themes](https://github.com/linuxbeginnings/hyprland-dots/tree/main/config): `config`

### Other components

- **Desktop User**

## Connections

- Desktop User → Display Controls: opens with shortcut (evidence: `README.md`)
- Desktop User → Display Controls: opens from settings (evidence: `README.md`)
- Display Controls → Monitor Layout: writes layout (evidence: `README.md`)
- Hyprland Config → Monitor Layout: loads configuration (evidence: `README.md`)
- Display Controls → Monitor Profiles: lists legacy layouts (evidence: `README.md`)
- Profile Tools → Monitor Profiles: imports layouts (evidence: `README.md`)
- Desktop User → Overview Search: uses desktop shell
- Desktop User → Waybar: uses desktop shell
- Desktop User → Rofi Menus: opens menus
- Desktop User → Quickshell: uses shell
