initial work on hyprland for fws1

This commit is contained in:
ari committed 2026-09-08 16:21:14 -04:00
1 parent ed9d512d09
commit ef2e77b4eb
13 files changed
+638

No files matched your search

+1
View File
@@ -18,6 +18,7 @@ these cases where the source subdir and `~/.config` target differ.
| `fwbook/hypr/` | Hyprland config for `fwbook` (scrolling layout + noctalia); linked to `~/.config/hypr` |
| `hl-fwdesk/hypr/` | Hyprland config for `hl-fwdesk` (Steam console); **baked into the build** via `mountAsSource`, linked to `~/.config/hypr` |
| `hl-pi1/hypr/` | Hyprland config for `hl-pi1` (clock box); linked to `~/.config/hypr` |
| `hl-fws1/hypr/` | Hyprland config for `hl-fws1` (remote slim desktop); **baked into the build** via `mountAsSource`, linked to `~/.config/hypr` |
| `hl-pi1/quickshell/` | Quickshell configs for `hl-pi1` (full-screen clock + calendar); linked to `~/.config/quickshell` |
| `fwbook/quickshell/` | Quickshell configs for `fwbook` (scrolling overview); linked to `~/.config/quickshell` |
| `extra.nu` | Extra NuShell config sourced at shell startup |
+6
View File
@@ -0,0 +1,6 @@
{
"$schema": "https://raw.githubusercontent.com/LuaLS/vscode-lua/master/setting/schema.json",
"workspace.library": ["types"],
"diagnostics.globals": ["hl"],
"runtime.version": "Lua 5.4"
}
+26
View File
@@ -0,0 +1,26 @@
-- =========================
-- Animations
-- =========================
hl.animation({
leaf = "workspaces",
enabled = true,
speed = 2,
bezier = "default",
style = "slidevert",
})
hl.animation({
leaf = "windows",
enabled = true,
speed = 5,
bezier = "default",
style = "slidefade 60%",
})
hl.animation({
leaf = "windowsMove",
enabled = true,
speed = 5,
bezier = "default",
style = "slidefade 80%",
})
+6
View File
@@ -0,0 +1,6 @@
-- =========================
-- Autostart
-- =========================
hl.on("hyprland.start", function()
hl.exec_cmd("setpriv --ambient-caps -all -- hypridle")
end)
+11
View File
@@ -0,0 +1,11 @@
-- =========================
-- Environment
-- =========================
hl.env("XCURSOR_SIZE", "24")
hl.env("XCURSOR_THEME", "Adwaita")
hl.env("HYPRCURSOR_SIZE", "24")
hl.env("HYPRCURSOR_THEME", "")
hl.env("NIXOS_OZONE_WL", "1")
hl.env("QT_QPA_PLATFORM", "wayland")
hl.env("QT_WAYLAND_DISABLE_WINDOWDECORATION", "1")
hl.env("ELECTRON_OZONE_PLATFORM_HINT", "auto")
+36
View File
@@ -0,0 +1,36 @@
-- =========================
-- General / Layout
-- =========================
hl.config({
general = {
gaps_in = 0,
gaps_out = 1,
border_size = 1,
layout = "scrolling",
resize_on_border = true,
},
decoration = {
rounding = 12,
active_opacity = 1.0,
inactive_opacity = 0.9,
},
scrolling = {
column_width = 1,
fullscreen_on_one_column = true,
focus_fit_method = 0,
follow_focus = true,
explicit_column_widths = "0.5, 1.0",
},
cursor = {
sync_gsettings_theme = true,
enable_hyprcursor = false,
},
misc = {
disable_hyprland_logo = true,
focus_on_activate = true,
},
})
+9
View File
@@ -0,0 +1,9 @@
-- =========================
-- Input
-- =========================
hl.config({
input = {
kb_layout = "us",
follow_mouse = 1,
},
})
+40
View File
@@ -0,0 +1,40 @@
-- =========================
-- Keybindings
-- =========================
local mod = "SUPER"
-- =========================
-- General / Apps
-- =========================
hl.bind(mod .. " + T", hl.dsp.exec_cmd("ghostty"))
hl.bind(mod .. " + B", hl.dsp.exec_cmd("chromium"))
hl.bind(mod .. " + E", hl.dsp.exec_cmd("wofi-emoji"))
hl.bind(mod .. " + Q", hl.dsp.window.close())
-- =========================
-- Navigation
-- =========================
hl.bind(mod .. " + left", hl.dsp.focus({ direction = "left" }))
hl.bind(mod .. " + right", hl.dsp.focus({ direction = "right" }))
hl.bind(mod .. " + up", hl.dsp.focus({ workspace = "e-1" }))
hl.bind(mod .. " + down", hl.dsp.focus({ workspace = "e+1" }))
hl.bind(mod .. " + Tab", hl.dsp.window.cycle_next())
hl.bind(mod .. " + SHIFT + Tab", hl.dsp.focus({ monitor = "+1" }))
hl.bind(mod .. " + SHIFT + F", hl.dsp.window.fullscreen({ mode = "fullscreen", action = "toggle" }))
hl.bind(mod .. " + V", hl.dsp.window.float({ action = "toggle" }))
hl.bind(mod .. " + C", hl.dsp.layout("focus current"))
hl.bind("ALT + TAB", hl.dsp.window.cycle_next())
-- =========================
-- Resizing
-- =========================
hl.bind(mod .. " + minus", hl.dsp.layout("colresize -0.1"))
hl.bind(mod .. " + equal", hl.dsp.layout("colresize +0.1"))
hl.bind(mod .. " + SHIFT + minus", hl.dsp.window.resize({ x = 0, y = -50, relative = true }))
hl.bind(mod .. " + SHIFT + equal", hl.dsp.window.resize({ x = 0, y = 50, relative = true }))
-- =========================
-- Mouse drag (move / resize windows)
-- =========================
hl.bind(mod .. " + mouse:272", hl.dsp.window.drag(), { mouse = true })
hl.bind(mod .. " + mouse:273", hl.dsp.window.resize(), { mouse = true })
+4
View File
@@ -0,0 +1,4 @@
-- =========================
-- Monitors
-- =========================
hl.monitor({ output = "", mode = "preferred", position = "auto", scale = "auto" })
@@ -0,0 +1,37 @@
-- =========================
-- Window Rules
-- =========================
-- Mirrors configs/fwbook/hypr/conf/window-rules.lua. Rounding/clip is handled
-- globally in general.lua (decoration.rounding = 12); below we float the
-- small control/dialog utilities so they don't tile.
hl.window_rule({
name = "float-pavucontrol",
match = { class = "^(pavucontrol)$" },
float = true,
})
hl.window_rule({
name = "float-blueman",
match = { class = "^(blueman-manager)$" },
float = true,
})
hl.window_rule({
name = "float-calculator",
match = { class = "^(org.gnome.Calculator)$" },
float = true,
})
hl.window_rule({
name = "float-portal-gtk",
match = { class = "^(xdg-desktop-portal-gtk)$" },
float = true,
})
hl.window_rule({
name = "float-open-file",
match = { title = "^(Open File)$" },
float = true,
})
hl.window_rule({
name = "float-save-file",
match = { title = "^(Save File)$" },
float = true,
})
+8
View File
@@ -0,0 +1,8 @@
# configs/hl-fws1/hypr/dms/
Placeholder for DMS-generated Hyprland overrides (colors / layout / window
rules), mirroring `configs/fwbook/hypr/dms/`.
Nothing is mounted here yet, so nothing is required from `hyprland.lua`. When
DMS config is wired into this host, the generated `dms/*.lua` files will live
here and can be pulled in with `require("dms.layout")`, etc.
+15
View File
@@ -0,0 +1,15 @@
-- =========================
-- Hyprland (hl-fws1)
-- =========================
-- Remote-managed slim desktop. Same tiling model + keybindings as fwbook,
-- but without a touchpad and without a locally-launched shell (DMS is the
-- shell; its config is generated elsewhere and mounted later).
require("conf/env")
require("conf/general")
require("conf/animations")
require("conf/monitors")
require("conf/inputs")
require("conf/window-rules")
require("conf/keybindings")
require("conf/autostart")
+439
View File
@@ -0,0 +1,439 @@
-- =============================================================================
-- Hyprland Lua API — EmmyLua type stubs
-- =============================================================================
-- This file is never executed by Hyprland. It exists solely to give
-- lua-language-server type information for the `hl` global that Hyprland
-- injects at runtime (0.55+).
--
-- Coverage is based on the API surface used in conf/*.lua. Extend as needed
-- when new hl.* calls are added.
-- =============================================================================
-- ---------------------------------------------------------------------------
-- Shared primitive types
-- ---------------------------------------------------------------------------
---@class hl.ConfigTable
---A free-form table mirroring Hyprland's hyprlang config sections.
---Top-level keys map to sections (general, decoration, input, …).
---Nested tables map to sub-sections. Values are numbers, booleans, or strings.
---@class hl.DispatcherValue
---An opaque value returned by hl.dsp.* factory functions.
---Pass directly to hl.bind() as the `action` argument.
-- ---------------------------------------------------------------------------
-- hl.dsp — dispatcher factories
-- ---------------------------------------------------------------------------
---@class hl.dsp.FocusOpts
---@field direction? "left"|"right"|"up"|"down" Focus by direction
---@field workspace? string|integer e.g. "e-1", "e+1", or a numeric id
---@field monitor? string e.g. "+1", "-1", name
---@field on_current_monitor? boolean Switch to the workspace on the current monitor
---@class hl.dsp.MoveOpts
---@field direction? "left"|"right"|"up"|"down"
---@field workspace? string e.g. "r-1", "r+1"
---@field monitor? "l"|"r"|"u"|"d"|string
---@field follow? boolean Follow the window after move
---@class hl.dsp.FullscreenOpts
---@field mode? "fullscreen"|"maximize"|"float"
---@field action? "toggle"|"on"|"off"
---@class hl.dsp.FloatOpts
---@field action? "toggle"|"on"|"off"
---@class hl.dsp.ResizeOpts
---@field x number Pixel delta (horizontal)
---@field y number Pixel delta (vertical)
---@field relative boolean If true, delta is relative to current size
---@class hl.dsp
local dsp = {}
---Focus a window or workspace.
---@param opts hl.dsp.FocusOpts
---@return hl.DispatcherValue
function dsp.focus(opts) end
---Execute a shell command.
---@param cmd string
---@return hl.DispatcherValue
function dsp.exec_cmd(cmd) end
---Invoke a named scrolling-layout dispatcher (colresize, swapcol, etc.).
---@param action string e.g. "colresize +0.1", "swapcol l", "fit_into_view", "focus current"
---@return hl.DispatcherValue
function dsp.layout(action) end
---@class hl.dsp.window
local dsp_window = {}
---Close the focused window.
---@return hl.DispatcherValue
function dsp_window.close() end
---Cycle focus to the next window.
---@return hl.DispatcherValue
function dsp_window.cycle_next() end
---Swap the focused window with a neighbour.
---@param opts? { direction: "l"|"r"|"u"|"d" }
---@return hl.DispatcherValue
function dsp_window.swap(opts) end
---Move the focused window.
---@param opts hl.dsp.MoveOpts
---@return hl.DispatcherValue
function dsp_window.move(opts) end
---Toggle/set fullscreen on the focused window.
---@param opts? hl.dsp.FullscreenOpts
---@return hl.DispatcherValue
function dsp_window.fullscreen(opts) end
---Toggle/set floating on the focused window.
---@param opts? hl.dsp.FloatOpts
---@return hl.DispatcherValue
function dsp_window.float(opts) end
---Resize the focused window by a pixel delta.
---@param opts? hl.dsp.ResizeOpts
---@return hl.DispatcherValue
function dsp_window.resize(opts) end
---Begin an interactive mouse drag (move) on the focused window.
---@return hl.DispatcherValue
function dsp_window.drag() end
---@class hl.dsp.group
local dsp_group = {}
---Toggle the focused window's group/tab mode.
---@return hl.DispatcherValue
function dsp_group.toggle() end
-- group dispatchers beyond `toggle` (moveintogroup/moveoutofgroup,
-- changegroupactive, lockactivegroup) aren't wrapped by hl.dsp;
-- keybindings.lua reaches them via `hl.exec_cmd("hyprctl dispatch ...")`.
---@class hl.dsp.workspace
local dsp_workspace = {}
---Toggle a special (scratchpad) workspace.
---@param name string
---@return hl.DispatcherValue
function dsp_workspace.toggle_special(name) end
---Focus a window in pseudo-tile mode.
---@return hl.DispatcherValue
function dsp_window.pseudo() end
-- Attach sub-namespaces to dsp
dsp.window = dsp_window
dsp.group = dsp_group
dsp.workspace = dsp_workspace
-- ---------------------------------------------------------------------------
-- hl.bind — keyboard / mouse bindings
-- ---------------------------------------------------------------------------
---@class hl.BindOpts
---@field mouse? boolean True for mouse-button bindings (mouse:272, mouse:273 …)
---@field locked? boolean Active even on a locked screen (e.g. media keys)
---@field repeating? boolean Fire repeatedly while held (note: key is `repeating`, not `repeat`)
---Register a keybind. Returns a handle with a `:set_enabled(bool)` method.
---@param keys string Modifier + key string, e.g. "SUPER + T"
---@param action hl.DispatcherValue | fun() An hl.dsp.* factory result, or a Lua callback
---@param opts? hl.BindOpts
---@return hl.BindHandle
function hl.bind(keys, action, opts) end
---@class hl.BindHandle
local BindHandle = {}
---Enable or disable this bind at runtime.
---@param enabled boolean
function BindHandle:set_enabled(enabled) end
-- ---------------------------------------------------------------------------
-- hl.config — set hyprlang config values
-- ---------------------------------------------------------------------------
---Apply a hyprlang config table. Sections that are omitted are left unchanged.
---@param cfg hl.ConfigTable
function hl.config(cfg) end
-- ---------------------------------------------------------------------------
-- hl.env — environment variables
-- ---------------------------------------------------------------------------
---Set a Wayland/compositor environment variable.
---@param name string
---@param value string
function hl.env(name, value) end
-- ---------------------------------------------------------------------------
-- hl.monitor — output / display configuration
-- ---------------------------------------------------------------------------
---@class hl.MonitorOpts
---@field output string Connector name ("eDP-1") or desc: string, or "" for fallback
---@field mode string Resolution@refresh, e.g. "1920x1080@60", or "preferred"
---@field position string "XxY" pixel offset, or "auto"
---@field scale number|string DPI scale factor, or "auto"
---@field transform? number 0–7 (90° steps + mirror variants)
---Configure a monitor/output.
---@param opts hl.MonitorOpts
function hl.monitor(opts) end
-- ---------------------------------------------------------------------------
-- hl.device — per-device input config
-- ---------------------------------------------------------------------------
---@class hl.DeviceOpts
---@field name string Device name as reported by libinput
---@field sensitivity? number -1.0 to 1.0
---@field kb_layout? string
---Apply per-device config.
---@param opts hl.DeviceOpts
function hl.device(opts) end
-- ---------------------------------------------------------------------------
-- hl.permission — capability permissions
-- ---------------------------------------------------------------------------
---Grant or deny a permission to a binary (regex path).
---@param binary string Regex matched against the process path
---@param capability string e.g. "screencopy", "plugin"
---@param action "allow"|"deny"
function hl.permission(binary, capability, action) end
-- ---------------------------------------------------------------------------
-- hl.workspace_rule — workspace rules
-- ---------------------------------------------------------------------------
---@class hl.WorkspaceRuleOpts
---@field workspace string Workspace selector, e.g. "w[tv1]", "f[1]"
---@field gaps_in? number
---@field gaps_out? number
---@field border_size? number
---Add a workspace rule.
---@param opts hl.WorkspaceRuleOpts
---@return hl.RuleHandle
function hl.workspace_rule(opts) end
-- ---------------------------------------------------------------------------
-- hl.layer_rule — layer-shell rules
-- ---------------------------------------------------------------------------
---@class hl.LayerRuleMatchOpts
---@field namespace? string Regex matched against the layer namespace
---@class hl.LayerRuleOpts
---@field name string
---@field match hl.LayerRuleMatchOpts
---@field no_anim? boolean
---Add a layer-shell rule.
---@param opts hl.LayerRuleOpts
---@return hl.RuleHandle
function hl.layer_rule(opts) end
-- ---------------------------------------------------------------------------
-- hl.gesture — built-in touchpad gesture bindings
-- ---------------------------------------------------------------------------
---@class hl.GestureOpts
---@field fingers number Number of touch points
---@field direction "horizontal"|"vertical"|"left"|"right"|"up"|"down"
---@field action string|fun() Named action or callback
---@field mods? string Modifier mask, e.g. "SUPER"
---Register a built-in touchpad gesture.
---@param opts hl.GestureOpts
function hl.gesture(opts) end
-- ---------------------------------------------------------------------------
-- hl.curve — animation bezier / spring curves
-- ---------------------------------------------------------------------------
---@class hl.CurveOpts
---@field type "bezier"|"spring"
---@field points? { [1]: number, [2]: number }[] Control points for bezier (two {x,y} pairs)
---@field mass? number Spring mass
---@field stiffness? number Spring stiffness
---@field dampening? number Spring dampening
---Define a named animation curve.
---@param name string
---@param opts hl.CurveOpts
function hl.curve(name, opts) end
-- ---------------------------------------------------------------------------
-- hl.animation — animation configuration
-- ---------------------------------------------------------------------------
---@class hl.AnimationOpts
---@field leaf string Animation leaf name, e.g. "workspaces", "windows", "fadeIn"
---@field enabled boolean
---@field speed number Duration multiplier
---@field bezier? string Named bezier curve defined via hl.curve()
---@field spring? string Named spring curve defined via hl.curve()
---@field style? string Optional style string, e.g. "slidevert", "slidefade 20%", "popin 87%", "fade"
---Configure an animation leaf.
---@param opts hl.AnimationOpts
function hl.animation(opts) end
-- ---------------------------------------------------------------------------
-- hl.window_rule — window rules
-- ---------------------------------------------------------------------------
---@class hl.WindowRuleMatchOpts
---@field class? string Regex matched against window class (app_id)
---@field title? string Regex matched against window title
---@field float? boolean Match floating windows
---@field fullscreen? boolean Match fullscreen windows
---@field pin? boolean Match pinned windows
---@field xwayland? boolean Match XWayland windows
---@field workspace? string Match by workspace selector
---@class hl.WindowRuleOpts
---@field name string Identifier for the rule
---@field match hl.WindowRuleMatchOpts Match criteria
---@field float? boolean Float the window
---@field tile? boolean Force-tile the window
---@field pin? boolean Pin (always-on-top) the window
---@field opacity? number Override active opacity
---@field no_focus? boolean Prevent focus
---@field border_size? number Override border size
---@field rounding? number Override corner rounding
---@field move? string Position string, e.g. "20 monitor_h-120"
---@field suppress_event? string Event name to suppress, e.g. "maximize"
---Add a window rule. Returns a handle with a `:set_enabled(bool)` method.
---@param opts hl.WindowRuleOpts
---@return hl.RuleHandle
function hl.window_rule(opts) end
---@class hl.RuleHandle
local RuleHandle = {}
---Enable or disable this rule at runtime.
---@param enabled boolean
function RuleHandle:set_enabled(enabled) end
-- ---------------------------------------------------------------------------
-- hl.on — event hooks
-- ---------------------------------------------------------------------------
---Register a callback for a Hyprland event.
---@param event string e.g. "hyprland.start", "window.open", "monitor.added"
---@param callback fun()
function hl.on(event, callback) end
-- ---------------------------------------------------------------------------
-- hl.exec_cmd — fire-and-forget command (outside a bind)
-- ---------------------------------------------------------------------------
---Execute a shell command immediately (not as a dispatcher).
---@param cmd string
function hl.exec_cmd(cmd) end
-- ---------------------------------------------------------------------------
-- hl.plugin — plugin management
-- ---------------------------------------------------------------------------
---@class hl.plugin
local plugin = {}
---Load a Hyprland plugin from its .so path.
---@param path string Absolute path to the shared library
function plugin.load(path) end
-- ---------------------------------------------------------------------------
-- hl.get_workspaces — runtime introspection
-- ---------------------------------------------------------------------------
---@class HL.Monitor
---@field id integer
---@field name string
---@field description? string
---@field width? integer
---@field height? integer
---@field x? integer
---@field y? integer
---@field scale? number
---@field focused? boolean
---@field active_workspace? HL.Workspace
---@class HL.Workspace
---@field id integer
---@field name string
---@field config_name? string Config-specified name (empty/absent for auto)
---@field windows? integer Number of windows on the workspace
---@field special? boolean Is a special (scratchpad) workspace
---@field active? boolean Is active on its monitor
---@field visible? boolean
---@field has_urgent? boolean
---@field is_empty? boolean
---@field monitor? HL.Monitor
---All non-inert workspaces.
---@return HL.Workspace[]
function hl.get_workspaces() end
-- ---------------------------------------------------------------------------
-- hl.print — log to the Hyprland log
-- ---------------------------------------------------------------------------
---@param ... any
function hl.print(...) end
-- ---------------------------------------------------------------------------
-- hl.dispatch — execute a dispatcher closure now
-- ---------------------------------------------------------------------------
---Run a dispatcher closure immediately (same as firing a bound key's action).
---@param action hl.DispatcherValue
function hl.dispatch(action) end
-- ---------------------------------------------------------------------------
-- hl.timer — deferred / repeating callbacks
-- ---------------------------------------------------------------------------
---@class hl.TimerOpts
---@field timeout number Interval / delay in milliseconds
---@field type? "repeat"|"oneshot"
---@class hl.TimerHandle
local TimerHandle = {}
---Cancel this timer.
function TimerHandle:cancel() end
---Schedule a callback on a repeating or one-shot timer.
---@param callback fun()
---@param opts hl.TimerOpts
---@return hl.TimerHandle
function hl.timer(callback, opts) end
-- ---------------------------------------------------------------------------
-- Global `hl` declaration
-- ---------------------------------------------------------------------------
---Hyprland Lua API — injected globally by the compositor at startup.
---@class hl
---@field dsp hl.dsp Dispatcher factories (actions for binds/gestures)
---@field plugin hl.plugin Plugin loader and plugin sub-namespaces
hl = {
dsp = dsp,
plugin = plugin,
}
-- Ensure the global is visible to LuaLS in all files.
---@type hl
hl = hl