Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Every setting

One row for each top-level setting in config.lua, and each links to where the configuration reference explains it. A setting is written in ~/.config/solium/user.lua, which holds only what you change:

return {
    gap = 4,
    tiling = { split = 0.618 },
}
SettingDefaultWhat it is
gap12Space between windows and around the work area, in logical pixels.
wallpaper"solium"The wallpaper.
shell{ … }A shell: the bar, the dock, the launcher. Keys: scene, on, outside_click, keyboard.
previewtrueThe compositor’s own preview shell: a bar, built as configuration on the same public API shell above describes (lua/preview/, qml/preview/; see docs/ricing.md).
keyboard{ … }The keyboard: its xkb layouts (layout, variant, options, model, rules, active), the locks (caps, num), the repeat rate, and the keyboard pill. Keys: indicator.
bindings{}The keys, and what they do.
cursor{}The pointer.
qml{ … }How QML – the frames, the pointer, the wallpaper – is rendered. Keys: renderer, probe_timeout.
monitors{}The monitors.
idle{ … }When nobody is at the machine. Keys: screens_off_after, off_frame_interval, dbus_inhibit.
session{ … }Telling the rest of the session that Solium is its desktop. Keys: systemd, autostart, stop_timeout.
pane"top"How every window is framed.
loading{ … }What a window does between being asked for and its application arriving. Keys: scene, patience, reserves_a_slot, decorated, fade.
resize{ … }What a window looks like while you are dragging its edge. Keys: fill.
fullscreen{ … }A fullscreen window: what it covers, and how a window goes fullscreen and comes back (super+f, or the application asking). Keys: covers, animate, instant.
maximize{ … }How a window is maximised to fill the work area of its monitor, and restored (super+shift+m, or the button on its frame). Keys: animate, instant.
floating{ … }Keys: client_limits.
tiling{ … }Keys: split, minimum, client_minimum, client_maximum, client_size_ignore, overflow, follow_overflow, motion, snap, reflow_on_close, move.
scrolling{ … }Keys: widths, default_width, motion, snap, reflow_on_close.
workspaces{ … }Keys: per_monitor, arrangement, columns, rows, spread, motion, follow_new_windows.
open{ … }Keys: motion, scale.
genie_spread1.4How much of a window trails behind it in the genie, for the Developer Tweaks panel’s version of that effect (--debug-mode only).