Config API

Use gnoblin.configure for settings, named shortcuts and autostart commands. The reference pages list the supported fields and defaults.

Functions

• gnoblin.configure — set compositor, shell, input and window-management options.
• gnoblin.window_rule — add a window or layer-surface rule.
• gnoblin.permission_rule — add a portal permission rule.
• gnoblin.animation — register a named animation.
• gnoblin.config — inspect or edit the config assembled during loading.
• gnoblin.load — load another Lua config file.
• gnoblin.snapshot — inspect a copy of the current config.
• gnoblin.array — mark a Lua table as a list.
• gnoblin.on — handle events and inspect registered callbacks with gnoblin.listeners.

The named views gnoblin.configure.shortcuts and gnoblin.configure.autostart read or update entries by name. See the shortcuts and autostart guides. Lua's require loader is covered under gnoblin.load.

First config

On first login, gnoblin-session copies the packaged reference config to ~/.config/gnoblin/init.lua when that file does not exist. It does not replace an existing config. Edit that file to configure Gnoblin.

gnoblinctl config path
gnoblinctl config reload

See configuration recipes for complete examples and the guides for task-based instructions.