Recipes

Short Lua examples for common desktop configuration tasks. Add a recipe to ~/.config/gnoblin/init.lua after any gnoblin.load(...) lines so your choices override settings loaded from other files.

After editing the file, apply the changes with gnoblinctl config reload.

• Complete starter config: start with a working shell, shortcut and window rule setup.
• Add a shortcut: add or change one named shortcut without replacing other shortcuts.
• Dim unfocused windows: lower the opacity of windows that are not focused.
• Round application windows: set window corner radius and smoothing.
• Turn off layer animations: disable compositor animations for layer surfaces.
• Request a Gnoblin titlebar: provide a server titlebar when an application requests one.
• Combine window rules: apply defaults and override selected values for matching windows.
• Split a config into files: load separate files for appearance and shortcuts.
• Set up a writing workspace: declare stable workspace IDs, route editor windows, and create a temporary workspace from a Lua event callback.
• Build a small desktop: start a bar, notifications, launcher and terminal.
• Set up a laptop for two keyboard layouts: configure XKB layouts, keyboard options and touchpad gestures.
• Make pointer feedback easier to see: enlarge the cursor and enable locate-pointer and visual-bell effects.
• Set up a pen display: map a tablet and configure a stylus button.
• Organize a growing config: split rules and shortcuts into loaded Lua files.
• Route new app windows to named workspaces: send new editor, browser and chat windows to stable workspace IDs.
• Give an app a springy entrance: register keyframes and apply them to one application.

See the configuration reference for available options and the configuration guides for behavior and tradeoffs.