How linuxbeginnings/hyprland-dots works
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: DisplayProfileMenu.sh Display Controls · monitors.lua Monitor Layout · Monitor_Profiles Monitor Profiles · hyprland.lua Hyprland Config
Components 18
Desktop Configuration
- Hyprland Config
config/hypr/hyprland.lua - User Settings
config/hypr/UserConfigs - Animation Profiles
config/hypr/animations - Lock Screen
config/hypr/hyprlock.conf
Display Layouts
- Monitor Layout
config/hypr/UserConfigs/monitors.lua - Monitor Profiles
config/hypr/Monitor_Profiles - Display Controls
config/hypr/scripts/DisplayProfileMenu.sh - Profile Tools
config/hypr/scripts/DisplayProfileSetup.sh
Shell Interfaces
- AGS Shell
config/ags/config.js - Overview Search
config/ags/modules/overview/windowcontent.js - Window Overview
config/ags/modules/overview/overview_hyprland.js - Quickshell
config/quickshell - Waybar
config/hypr/waybar
Desktop Utilities
- Rofi Menus
config/hypr/rofi - Hyprland Scripts
config/hypr/scripts - Weather Utility
config/hypr/UserScripts/Weather.py - Application Themes
config
Other components
- Desktop User
Connections 10
- Desktop User → Display Controls: opens with shortcut
README.md - Desktop User → Display Controls: opens from settings
README.md - Display Controls → Monitor Layout: writes layout
README.md - Hyprland Config → Monitor Layout: loads configuration
README.md - Display Controls → Monitor Profiles: lists legacy layouts
README.md - Profile Tools → Monitor Profiles: imports layouts
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