Hyprland

./compositor_config

What's inside

My Hyprland setup uses the Lua-based config system introduced in recent versions. It handles everything: autostart apps, window rules, keybindings, workspace modes, and integration with other tools (Waybar, Wofi, Hyprpaper).

The mode-switcher script is the fun part: it switches between "Travail" (work: code + firefox + discord, 2 kitty terminals) and "Détente" (relax: just firefox + discord). One keybind, two workflows.

Main Configuration

hypr/hyprland.lua

Download

-- ================================================================= -- CONFIGURATION HYPRLAND (LUA) -- ================================================================= hl.config({ autogenerated = false }) ------------------ ---- MONITORS ---- ------------------ hl.monitor({ output = "", mode = "preferred", position = "auto", scale = "auto", }) --------------------- ---- MY PROGRAMS ---- --------------------- local terminal = "kitty" local fileManager = "thunar" local menu = "wofi --show drun" ------------------- ---- AUTOSTART ---- ------------------- hl.on("hyprland.start", function () hl.exec_cmd("killall -q waybar; waybar &") hl.exec_cmd("killall -q hyprpaper; hyprpaper &") -- window rules for calendar, blur layers, audio/brightness binds... hl.exec_cmd("hyprsunset &") hl.exec_cmd("~/.config/hypr/scripts/mode-switcher.sh --default detente") hl.exec_cmd("rfkill unblock bluetooth") hl.exec_cmd("wl-paste --type text --watch cliphist store") end) ------------------------------- ---- ENVIRONMENT VARIABLES ---- ------------------------------- hl.env("XCURSOR_SIZE", "24") hl.env("HYPRCURSOR_SIZE", "24") ----------------------- ---- LOOK AND FEEL ---- ----------------------- hl.config({ general = { gaps_in = 5, gaps_out = 10, border_size = 2, col = { active_border = { colors = {"rgba(33ccffee)", "rgba(00ff99ee)"}, angle = 45 }, inactive_border = "rgba(595959aa)", }, layout = "dwindle", }, decoration = { rounding = 10, shadow = { enabled = true, range = 4, color = 0xee1a1a1a }, blur = { enabled = true, size = 3, passes = 1, vibrancy = 0.1696 }, }, }) -- ... (keybindings, window rules, gestures)

Show full file (150+ lines)

hypr/hyprlock.conf

Download

background { monitor = path = $HOME/Images/bg.png blur_passes = 0 contrast = 1.0 brightness = 1.0 vibrancy = 0.2 } input-field { size = 200, 50 outline_thickness = 3 dots_size = 0.33 dots_spacing = 0.15 fade_on_empty = false placeholder_text = <i>Mot de passe...</i> } auth { fingerprint { enabled = true ready_message = (Scan fingerprint to unlock) } }

hypr/hyprpaper.conf

Download

preload = $HOME/Images/bg.png wallpaper { monitor = eDP-1 path = $HOME/Images/bg.png } splash = false ipc = on

hypr/hyprsunset.conf

Download

profile { time = 19:00 temperature = 4000 } profile { time = 09:00 temperature = 6000 }

Scripts

Three helper scripts bound to Hyprland keybindings (screenshot, quick notes, workspace mode switcher).

screenshot.sh

Region screenshot with grim + slurp, copies to clipboard, sends a notification. Bound to Print.

Download

quicknote.sh

Creates a timestamped note in ~/notes/ and opens it in Vim inside a new Kitty window. Bound to Super + N.

Download

mode-switcher.sh

Switches between Travail (2 kitty + code + firefox + discord) and Détente (firefox + discord). Uses hyprctl and jq. Bound to Super + Tab.

Download

Plugins

split-monitor-workspaces

A Hyprland plugin that allows per-monitor workspaces. Each monitor gets its own set of workspaces (e.g., 1-5 on the laptop screen, 6-0 on the external monitor). This solves the classic issue where workspaces are shared across all monitors.

Installed via hyprpm (Hyprland Plugin Manager). Repository: levnikmyskin/hyprland-split-monitor-workspaces

Note: the plugin source is present in my dotfiles as a submodule but is not modified. It's purely a dependency.

Back to /uses