Skip to content

Complete starter config ​

Save this as ~/.config/gnoblin/init.lua. Install the commands you use; replace ptyxis with your terminal.

lua
-- Keep your shell installer's includes if it provided different paths.
gnoblin.load("/usr/share/gnoblin/conf.d/*.lua")
gnoblin.load("conf.d/**/*.lua")

gnoblin.configure {
    shell = {
        minimize_animation = "zoom",
        minimize_duration = 150,
    },
}

gnoblin.configure {shortcuts = {terminal = {binding = "<Super>Return", command = {"ptyxis", "--new-window"}}}}

gnoblin.window_rule {
    match = {type = "window", focused = false},
    opacity = 0.95,
}
SettingAccepted valuesDefaultEffect
minimize_animation"zoom", "fade", "none", "gnome", or a registered name"zoom"Selects the minimize motion. See animation settings.
minimize_durationInteger milliseconds from 0 to 5000200Sets the motion duration; this example uses 150 ms.
bindingOne GTK accelerator stringNot setRuns the shortcut when pressed. See accelerator syntax.
commandNonempty array of stringsNot setExecutable followed by its arguments; Gnoblin does not expand shell syntax.
focusedBooleanNot setfalse matches application windows without focus.
opacityNumber from 0 to 11Sets matching windows' opacity; 1 is fully opaque.

Save the file and run gnoblinctl config reload to apply it. See the shortcut reference and window rule reference for field constraints and precedence.

This adds a terminal shortcut and dims unfocused windows. It does not install or start a desktop shell; choose one in shell setup. If an imported shortcut already uses Super+Enter under another name, override that name instead. See the shell settings, shortcut settings, and window rule reference for accepted values.