superdarke14/dotfiles

Purpose and Entry Points

This repository is a personal Linux desktop/window-manager configuration set, centered on Hyprland and related idle, lock, wallpaper, and theming services. Primary runtime entry points are hyprland.conf, hypridle.conf, hyprlock.conf, hyprpaper.conf, and rc.lua.

Hyprland Session Configuration

hyprland.conf is the main compositor configuration and likely defines monitor, input, window, workspace, keybinding, and startup behavior. hyprland_idle.config appears to be an alternate or legacy Hyprland idle-policy file. Hyprland is the central process boundary: it launches and coordinates the Wayland desktop session.

Idle and Screen-Lock Pipeline

Idle detection is configured through hypridle.conf for Hyprland-native idle management, with swayidle.config retained as an alternative configuration for the Sway-compatible idle daemon. Lock-screen behavior is defined in hyprlock.conf; hyprlock_backup.conf preserves a fallback version. The expected flow is inactivity detection → screen/session actions → lock invocation.

Wallpaper and Visual Theme

hyprpaper.conf configures Hyprpaper, the wallpaper service used alongside Hyprland. Visual consistency also crosses into Lua-based theme definitions in theme.lua, allowing a common color/style source for Lua consumers and compositor-adjacent configuration.

Lua-Configured Desktop Component

rc.lua is the entry point for a Lua-configured component, most plausibly an AwesomeWM configuration or another Lua-driven desktop utility. It is architecturally separate from the Hyprland configuration path, indicating either an alternate window-manager setup or shared desktop customization.

Configuration History and Recovery

config_backup and hyprlock_backup.conf provide recovery/fallback boundaries for active configuration. config likely holds an additional generic configuration artifact or directory-level configuration source. These backups allow desktop-session settings to be restored without changing the primary active files.