gnoblin.configure.autostart

autostart maps each entry name to a command Gnoblin starts in the user session after Mutter publishes its Wayland display. Put these settings in ~/.config/gnoblin/init.lua.

On this page

Type definition

Field	Accepted values	Default and effect
Name	1–80 letters, numbers, `_` or `-`	Identifies the entry when another config merges it.
`command`	Nonempty array of strings	Required. Runs directly, without shell expansion.
`when`	`"on_login"`	`"on_login"`, the only supported trigger.
`enable`	Boolean	`true`; set to `false` to disable an imported entry.

Use the same name to override an imported command. Omitted fields keep their earlier values. Removing or disabling an entry stops its Gnoblin-owned process group on config reload, including descendants that remain in that group.

Lua

gnoblin.configure {
    autostart = {
        panel = {command = {"waybar", "--config", "/home/you/.config/waybar/config"}},
    },
}

If an earlier config file defines waybar, you can change it directly by name. enable defaults to true:

Lua

gnoblin.configure.autostart.waybar.enable = false

Firefox below Waybar in a Gnoblin session

Waybar starts as an independent session client; Firefox is a regular application window.

Loop over autostart entries loaded earlier in the config:

Lua

for name, entry in pairs(gnoblin.configure.autostart) do
    if entry.enable then
        print(name, table.concat(entry.command, " "))
    end
end

Use one array item per command argument. Commands run directly, so pipes, redirection and other shell syntax require explicitly launching a shell. See command syntax and the autostart guide for launch timing and overrides.

An invalid command logs a warning and does not prevent other entries from starting. Gnoblin does not restart a command after it exits.

An invalid entry makes gnoblinctl config reload fail and names the entry, for example autostart "bar" has an unsupported field "cmd"; use name, command or when. The previous configuration stays active and the session keeps running. An entry is invalid when:

it has no name, a name longer than 80 characters, or a name used twice
it has a field other than name, command or when
when is set to anything other than "on_login"
command is not a list, is empty, or has an item that is not a string

Type definition

This is schema pseudocode in Lua table form. ? marks an optional field; ["entry-name"] stands for any valid entry name.

Lua

gnoblin.configure {
    autostart = {
        ["entry-name"] = {
            command = {string, ...},
            when = "on_login"?,
            enable = boolean?,
        },
    },
}