Add Hyprland config to dotfiles

- Pin workspaces 1-5 to DP-1 (native 5120x1440), 6 to HDMI-A-1
- Autostart work apps on ws1 and chat apps on ws2, loading notification
- Centered master layout (25/50/25) on the ultrawide, lone window at ~60%
- Resize, group and close keybinds; SUPER+Q closes window

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -27,7 +27,11 @@ This installs ansible if missing, then runs the playbook. Tasks are split by cat
 
 ## Architecture
 
-### Niri (Wayland compositor)
+### Hyprland (Wayland compositor, current)
+Single Lua config: `hypr/hyprland.lua` (Hyprland 0.56+, API stubs in `/usr/share/hypr/stubs/hl.meta.lua`). Apply with `hyprctl reload`, check `hyprctl configerrors`.
+Workspaces 1–5 are pinned to DP-1, 6 to HDMI-A-1. Startup apps are placed per workspace by window class rules.
+
+### Niri (Wayland compositor, previous)
 `niri/config.kdl` is just includes — the real config lives in `niri/cfg/`:
 - `input.kdl` — keyboard/mouse/touchpad settings
 - `keybinds.kdl` — all keybindings

hypr/hyprland.lua

@@ -0,0 +1,436 @@
+
+-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+-- AUTOGENERATED HYPRLAND CONFIG.                        --
+-- EDIT THIS CONFIG ACCORDING TO THE WIKI INSTRUCTIONS.  --
+-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+
+
+-- This is an example Hyprland Lua config file.
+-- Refer to the wiki for more information.
+-- https://wiki.hypr.land/Configuring/Start/
+
+-- Please note not all available settings / options are set here.
+-- For a full list, see the wiki
+
+-- You can (and should!!) split this configuration into multiple files
+-- Create your files separately and then require them like this:
+-- require("myColors")
+
+
+------------------
+---- MONITORS ----
+------------------
+
+-- See https://wiki.hypr.land/Configuring/Basics/Monitors/
+-- Same layout as kanshi/config: ultrawide on top, HDMI below it
+hl.monitor({ output = "DP-1",     mode = "5120x1440@59.98", position = "0x0",       scale = 1 })
+hl.monitor({ output = "HDMI-A-1", mode = "1920x1080@60",    position = "1600x1440", scale = 1 })
+hl.monitor({ output = "",         mode = "preferred",       position = "auto",      scale = "auto" })
+
+-- Workspaces 1-5 on the ultrawide, 6+ on HDMI (otherwise ws1 lands on HDMI)
+for i = 1, 5 do
+    hl.workspace_rule({ workspace = tostring(i), monitor = "DP-1", default = i == 1, persistent = true, layout = "master" })
+end
+hl.workspace_rule({ workspace = "6", monitor = "HDMI-A-1", default = true })
+
+
+---------------------
+---- MY PROGRAMS ----
+---------------------
+
+-- Set programs that you use
+local terminal    = "alacritty"
+local fileManager = "nautilus"
+local menu        = "noctalia msg panel-toggle launcher"
+
+
+-------------------
+---- AUTOSTART ----
+-------------------
+
+-- See https://wiki.hypr.land/Configuring/Basics/Autostart/
+
+-- Autostart necessary processes (like notifications daemons, status bars, etc.)
+-- Or execute your favorite apps at launch like this:
+--
+-- hl.on("hyprland.start", function () 
+--   hl.exec_cmd(terminal)
+--   hl.exec_cmd("nm-applet")
+--   hl.exec_cmd("waybar & hyprpaper & firefox")
+-- end)
+
+local webapp = "/usr/bin/helium-browser --profile-directory=Default --app-id="
+
+hl.on("hyprland.start", function ()
+    -- ponytail: "splash" is a compositor notification, shown until noctalia's wallpaper is up
+    hl.notification.create({ text = "Loading desktop…", timeout = 8000, font_size = 28 })
+    hl.exec_cmd("noctalia")
+    hl.exec_cmd("/usr/lib/hyprpolkitagent/hyprpolkitagent")
+
+    -- Workspace 1: work (placed by the window rules below)
+    hl.exec_cmd(webapp .. "dlgohinmglaoopaiplliaecdpmnepmga") -- Todoist
+    hl.exec_cmd(webapp .. "fmgjjmmmlfnkbppncabfkddbjimcfncm") -- Gmail
+    hl.exec_cmd(webapp .. "kjbdgfilnfhdoflbpgamdcdgpehopbep") -- Google Calendar
+    hl.exec_cmd("helium-browser --new-window", { workspace = "1 silent" })
+
+    -- Workspace 2: chat
+    hl.exec_cmd(webapp .. "hnpfjngllnobngcgfapefoaidbinmjnm") -- WhatsApp
+    hl.exec_cmd(webapp .. "nigookeodlehlnjcpdfifmophdcbjoma") -- Telegram
+    hl.exec_cmd("discord")
+
+    hl.dispatch(hl.dsp.focus({ workspace = 1 }))
+end)
+
+-- Web apps share one helium process, so place them by class instead of exec rules
+for class, ws in pairs({
+    ["chrome-dlgohinmglaoopaiplliaecdpmnepmga-Default"] = 1, -- Todoist
+    ["chrome-fmgjjmmmlfnkbppncabfkddbjimcfncm-Default"] = 1, -- Gmail
+    ["chrome-kjbdgfilnfhdoflbpgamdcdgpehopbep-Default"] = 1, -- Google Calendar
+    ["chrome-hnpfjngllnobngcgfapefoaidbinmjnm-Default"] = 2, -- WhatsApp
+    ["chrome-nigookeodlehlnjcpdfifmophdcbjoma-Default"] = 2, -- Telegram
+    discord = 2,
+}) do
+    hl.window_rule({ name = "ws-" .. class, match = { class = "^" .. class .. "$" }, workspace = ws .. " silent" })
+end
+
+
+-------------------------------
+---- ENVIRONMENT VARIABLES ----
+-------------------------------
+
+-- See https://wiki.hypr.land/Configuring/Advanced-and-Cool/Environment-variables/
+
+hl.env("XCURSOR_SIZE", "24")
+hl.env("HYPRCURSOR_SIZE", "24")
+
+
+-----------------------
+----- PERMISSIONS -----
+-----------------------
+
+-- See https://wiki.hypr.land/Configuring/Advanced-and-Cool/Permissions/
+-- Please note permission changes here require a Hyprland restart and are not applied on-the-fly
+-- for security reasons
+
+-- hl.config({
+--   ecosystem = {
+--     enforce_permissions = true,
+--   },
+-- })
+
+-- hl.permission("/usr/(bin|local/bin)/grim", "screencopy", "allow")
+-- hl.permission("/usr/(lib|libexec|lib64)/xdg-desktop-portal-hyprland", "screencopy", "allow")
+-- hl.permission("/usr/(bin|local/bin)/hyprpm", "plugin", "allow")
+
+
+-----------------------
+---- LOOK AND FEEL ----
+-----------------------
+
+-- Refer to https://wiki.hypr.land/Configuring/Basics/Variables/
+hl.config({
+    general = {
+        gaps_in  = 5,
+        gaps_out = 20,
+
+        border_size = 2,
+
+        col = {
+            active_border   = { colors = {"rgba(33ccffee)", "rgba(00ff99ee)"}, angle = 45 },
+            inactive_border = "rgba(595959aa)",
+        },
+
+        -- Set to true to enable resizing windows by clicking and dragging on borders and gaps
+        resize_on_border = false,
+
+        -- Please see https://wiki.hypr.land/Configuring/Advanced-and-Cool/Tearing/ before you turn this on
+        allow_tearing = false,
+
+        layout = "dwindle",
+    },
+
+    decoration = {
+        rounding       = 10,
+        rounding_power = 2,
+
+        -- Change transparency of focused and unfocused windows
+        active_opacity   = 1.0,
+        inactive_opacity = 1.0,
+
+        shadow = {
+            enabled      = true,
+            range        = 4,
+            render_power = 3,
+            color        = 0xee1a1a1a,
+        },
+
+        blur = {
+            enabled   = true,
+            size      = 3,
+            passes    = 1,
+            vibrancy  = 0.1696,
+        },
+    },
+
+    animations = {
+        enabled = true,
+    },
+})
+
+-- Default curves and animations, see https://wiki.hypr.land/Configuring/Advanced-and-Cool/Animations/
+hl.curve("easeOutQuint",   { type = "bezier", points = { {0.23, 1},    {0.32, 1}    } })
+hl.curve("easeInOutCubic", { type = "bezier", points = { {0.65, 0.05}, {0.36, 1}    } })
+hl.curve("linear",         { type = "bezier", points = { {0, 0},       {1, 1}       } })
+hl.curve("almostLinear",   { type = "bezier", points = { {0.5, 0.5},   {0.75, 1}    } })
+hl.curve("quick",          { type = "bezier", points = { {0.15, 0},    {0.1, 1}     } })
+
+-- Default springs
+hl.curve("easy",           { type = "spring", mass = 1, stiffness = 238.1191, dampening = 24.21279333 })
+
+hl.animation({ leaf = "global",        enabled = true,  speed = 10,   bezier = "default" })
+hl.animation({ leaf = "border",        enabled = true,  speed = 5.39, bezier = "easeOutQuint" })
+hl.animation({ leaf = "windows",       enabled = true,  speed = 4.79, spring = "easy" })
+hl.animation({ leaf = "windowsIn",     enabled = true,  speed = 4.1,  spring = "easy",         style = "popin 87%" })
+hl.animation({ leaf = "windowsOut",    enabled = true,  speed = 1.49, bezier = "linear",       style = "popin 87%" })
+hl.animation({ leaf = "fadeIn",        enabled = true,  speed = 1.73, bezier = "almostLinear" })
+hl.animation({ leaf = "fadeOut",       enabled = true,  speed = 1.46, bezier = "almostLinear" })
+hl.animation({ leaf = "fade",          enabled = true,  speed = 3.03, bezier = "quick" })
+hl.animation({ leaf = "layers",        enabled = true,  speed = 3.81, bezier = "easeOutQuint" })
+hl.animation({ leaf = "layersIn",      enabled = true,  speed = 4,    bezier = "easeOutQuint", style = "fade" })
+hl.animation({ leaf = "layersOut",     enabled = true,  speed = 1.5,  bezier = "linear",       style = "fade" })
+hl.animation({ leaf = "fadeLayersIn",  enabled = true,  speed = 1.79, bezier = "almostLinear" })
+hl.animation({ leaf = "fadeLayersOut", enabled = true,  speed = 1.39, bezier = "almostLinear" })
+hl.animation({ leaf = "workspaces",    enabled = true,  speed = 1.94, bezier = "almostLinear", style = "fade" })
+hl.animation({ leaf = "workspacesIn",  enabled = true,  speed = 1.21, bezier = "almostLinear", style = "fade" })
+hl.animation({ leaf = "workspacesOut", enabled = true,  speed = 1.94, bezier = "almostLinear", style = "fade" })
+hl.animation({ leaf = "zoomFactor",    enabled = true,  speed = 7,    bezier = "quick" })
+
+-- Ref https://wiki.hypr.land/Configuring/Basics/Workspace-Rules/
+-- "Smart gaps" / "No gaps when only"
+-- uncomment all if you wish to use that.
+-- hl.workspace_rule({ workspace = "w[tv1]", gaps_out = 0, gaps_in = 0 })
+-- hl.workspace_rule({ workspace = "f[1]",   gaps_out = 0, gaps_in = 0 })
+-- hl.window_rule({
+--     name  = "no-gaps-wtv1",
+--     match = { float = false, workspace = "w[tv1]" },
+--     border_size = 0,
+--     rounding    = 0,
+-- })
+-- hl.window_rule({
+--     name  = "no-gaps-f1",
+--     match = { float = false, workspace = "f[1]" },
+--     border_size = 0,
+--     rounding    = 0,
+-- })
+
+-- See https://wiki.hypr.land/Configuring/Layouts/Dwindle-Layout/ for more
+hl.config({
+    dwindle = {
+        preserve_split = true, -- You probably want this
+    },
+})
+
+-- See https://wiki.hypr.land/Configuring/Layouts/Master-Layout/ for more
+hl.config({
+    -- Ultrawide workspaces: main window centered at 50%, others stack in 25% columns left/right
+    master = {
+        orientation   = "center",
+        mfact         = 0.5,
+        new_status    = "slave", -- new windows go to the sides, main stays put
+        slave_count_for_center_master = 2,
+    },
+})
+
+-- See https://wiki.hypr.land/Configuring/Layouts/Scrolling-Layout/ for more
+hl.config({
+    scrolling = {
+        fullscreen_on_one_column = true,
+    },
+})
+
+-- A lone tiled window is centered at ~60% width on the ultrawide (3072/1440).
+-- On 16:9 screens this ratio is wider than the screen, so it stays full size.
+hl.config({
+    layout = {
+        single_window_aspect_ratio = { 32, 15 },
+    },
+})
+
+----------------
+----  MISC  ----
+----------------
+
+hl.config({
+    misc = {
+        force_default_wallpaper = -1,    -- Set to 0 or 1 to disable the anime mascot wallpapers
+        disable_hyprland_logo   = false, -- If true disables the random hyprland logo / anime girl background. :(
+    },
+})
+
+
+---------------
+---- INPUT ----
+---------------
+
+hl.config({
+    input = {
+        kb_layout  = "us",
+        kb_variant = "",
+        kb_model   = "",
+        kb_options = "",
+        kb_rules   = "",
+
+        follow_mouse = 1,
+
+        sensitivity = 0, -- -1.0 - 1.0, 0 means no modification.
+
+        touchpad = {
+            natural_scroll = false,
+        },
+    },
+})
+
+hl.gesture({
+    fingers = 3,
+    direction = "horizontal",
+    action = "workspace"
+})
+
+-- Example per-device config
+-- See https://wiki.hypr.land/Configuring/Advanced-and-Cool/Devices/ for more
+hl.device({
+    name        = "epic-mouse-v1",
+    sensitivity = -0.5,
+})
+
+
+---------------------
+---- KEYBINDINGS ----
+---------------------
+
+local mainMod = "SUPER" -- Sets "Windows" key as main modifier
+
+-- Example binds, see https://wiki.hypr.land/Configuring/Basics/Binds/ for more
+hl.bind(mainMod .. " + Q", hl.dsp.window.close())
+local closeWindowBind = hl.bind(mainMod .. " + C", hl.dsp.window.close())
+-- closeWindowBind:set_enabled(false)
+hl.bind(mainMod .. " + M", hl.dsp.exec_cmd("command -v hyprshutdown >/dev/null 2>&1 && hyprshutdown || hyprctl dispatch 'hl.dsp.exit()'"))
+hl.bind(mainMod .. " + E", hl.dsp.exec_cmd(fileManager))
+hl.bind(mainMod .. " + V", hl.dsp.window.float({ action = "toggle" }))
+hl.bind(mainMod .. " + R", hl.dsp.exec_cmd(menu))
+hl.bind(mainMod .. " + P", hl.dsp.window.pseudo())
+hl.bind(mainMod .. " + J", hl.dsp.layout("togglesplit"))    -- dwindle only (HDMI)
+hl.bind(mainMod .. " + Return", hl.dsp.layout("swapwithmaster"))  -- master only: make focused window the main one
+
+-- Ported from niri
+hl.bind("ALT + Return", hl.dsp.exec_cmd(terminal))
+hl.bind("ALT + Space",         hl.dsp.exec_cmd("noctalia msg panel-toggle launcher"))
+hl.bind("ALT + SHIFT + Space", hl.dsp.exec_cmd("noctalia msg window-switcher"))
+hl.bind(mainMod .. " + L",         hl.dsp.exec_cmd("noctalia msg session lock"))
+hl.bind(mainMod .. " + SHIFT + Q", hl.dsp.exec_cmd("noctalia msg panel-toggle session"))
+
+-- Move focus with ALT + hjkl
+hl.bind("ALT + H", hl.dsp.focus({ direction = "left" }))
+hl.bind("ALT + L", hl.dsp.focus({ direction = "right" }))
+hl.bind("ALT + K", hl.dsp.focus({ direction = "up" }))
+hl.bind("ALT + J", hl.dsp.focus({ direction = "down" }))
+
+-- Move window with ALT + SHIFT + hjkl
+hl.bind("ALT + SHIFT + H", hl.dsp.window.move({ direction = "left" }))
+hl.bind("ALT + SHIFT + L", hl.dsp.window.move({ direction = "right" }))
+hl.bind("ALT + SHIFT + K", hl.dsp.window.move({ direction = "up" }))
+hl.bind("ALT + SHIFT + J", hl.dsp.window.move({ direction = "down" }))
+
+-- Resize with ALT + CTRL + hjkl (hold to repeat)
+hl.bind("ALT + CTRL + H", hl.dsp.window.resize({ x = -175, y = 0,   relative = true }), { repeating = true })
+hl.bind("ALT + CTRL + L", hl.dsp.window.resize({ x = 175,  y = 0,   relative = true }), { repeating = true })
+hl.bind("ALT + CTRL + K", hl.dsp.window.resize({ x = 0,   y = -175, relative = true }), { repeating = true })
+hl.bind("ALT + CTRL + J", hl.dsp.window.resize({ x = 0,   y = 175,  relative = true }), { repeating = true })
+hl.bind("ALT + F", hl.dsp.window.fullscreen())
+
+-- Tabbed stacks: ALT+G groups windows, ALT+Tab cycles through the group
+hl.bind("ALT + G",   hl.dsp.group.toggle())
+hl.bind("ALT + Tab", hl.dsp.group.next())
+
+-- Switch workspaces with ALT + [1-9]
+-- Move active window to a workspace with ALT + SHIFT + [1-9]
+for i = 1, 9 do
+    hl.bind("ALT + " .. i,        hl.dsp.focus({ workspace = i}))
+    hl.bind("ALT + SHIFT + " .. i,    hl.dsp.window.move({ workspace = i }))
+end
+
+-- Example special workspace (scratchpad)
+hl.bind(mainMod .. " + S",         hl.dsp.workspace.toggle_special("magic"))
+hl.bind(mainMod .. " + SHIFT + S", hl.dsp.window.move({ workspace = "special:magic" }))
+
+-- Scroll through existing workspaces with mainMod + scroll
+hl.bind(mainMod .. " + mouse_down", hl.dsp.focus({ workspace = "e+1" }))
+hl.bind(mainMod .. " + mouse_up",   hl.dsp.focus({ workspace = "e-1" }))
+
+-- Move/resize windows with mainMod + LMB/RMB and dragging
+hl.bind(mainMod .. " + mouse:272", hl.dsp.window.drag(),   { mouse = true })
+hl.bind(mainMod .. " + mouse:273", hl.dsp.window.resize(), { mouse = true })
+
+-- Laptop multimedia keys for volume and LCD brightness
+hl.bind("XF86AudioRaiseVolume", hl.dsp.exec_cmd("noctalia msg volume-up"),       { locked = true, repeating = true })
+hl.bind("XF86AudioLowerVolume", hl.dsp.exec_cmd("noctalia msg volume-down"),     { locked = true, repeating = true })
+hl.bind("XF86AudioMute",        hl.dsp.exec_cmd("noctalia msg volume-mute"),     { locked = true })
+hl.bind("XF86AudioMicMute",     hl.dsp.exec_cmd("noctalia msg mic-mute"),        { locked = true })
+hl.bind("XF86MonBrightnessUp",  hl.dsp.exec_cmd("noctalia msg brightness-up"),   { locked = true, repeating = true })
+hl.bind("XF86MonBrightnessDown",hl.dsp.exec_cmd("noctalia msg brightness-down"), { locked = true, repeating = true })
+
+hl.bind("XF86AudioNext",  hl.dsp.exec_cmd("noctalia msg media next"),     { locked = true })
+hl.bind("XF86AudioPause", hl.dsp.exec_cmd("noctalia msg media toggle"),   { locked = true })
+hl.bind("XF86AudioPlay",  hl.dsp.exec_cmd("noctalia msg media toggle"),   { locked = true })
+hl.bind("XF86AudioPrev",  hl.dsp.exec_cmd("noctalia msg media previous"), { locked = true })
+
+
+--------------------------------
+---- WINDOWS AND WORKSPACES ----
+--------------------------------
+
+-- See https://wiki.hypr.land/Configuring/Basics/Window-Rules/
+-- and https://wiki.hypr.land/Configuring/Basics/Workspace-Rules/
+
+-- Example window rules that are useful
+
+local suppressMaximizeRule = hl.window_rule({
+    -- Ignore maximize requests from all apps. You'll probably like this.
+    name  = "suppress-maximize-events",
+    match = { class = ".*" },
+
+    suppress_event = "maximize",
+})
+-- suppressMaximizeRule:set_enabled(false)
+
+hl.window_rule({
+    -- Fix some dragging issues with XWayland
+    name  = "fix-xwayland-drags",
+    match = {
+        class      = "^$",
+        title      = "^$",
+        xwayland   = true,
+        float      = true,
+        fullscreen = false,
+        pin        = false,
+    },
+
+    no_focus = true,
+})
+
+-- Layer rules also return a handle.
+-- local overlayLayerRule = hl.layer_rule({
+--     name  = "no-anim-overlay",
+--     match = { namespace = "^my-overlay$" },
+--     no_anim = true,
+-- })
+-- overlayLayerRule:set_enabled(false)
+
+-- Hyprland-run windowrule
+hl.window_rule({
+    name  = "move-hyprland-run",
+    match = { class = "hyprland-run" },
+
+    move  = "20 monitor_h-120",
+    float = true,
+})

setup.sh

@@ -44,6 +44,7 @@ configlink picom.conf
 configlink niri
 configlink noctalia
 configlink kanshi
+configlink hypr
 
 checkdir ~/.claude
 link ~/.claude/settings.json ~/.dotfiles/claude/settings.json