Skip to content
GPUi Shell

Configuration

GPUi Shell loads configuration from:

  • $XDG_CONFIG_HOME/gpuishell/config.toml
  • or ~/.config/gpuishell/config.toml (fallback)

If the file does not exist, it is created with defaults on startup. Changes are hot-reloaded automatically.

config.toml example

Section titled “config.toml example”
[bar]
size = 32.0
position = "left"
start = ["LauncherBtn", "Workspaces", "SysInfo"]
center = ["ActiveWindow"]
end = ["Clock", "Mpris", "Notifications", "Systray", "KeyboardLayout", "Settings"]


[launcher]
width = 600.0
height = 450.0
margin_top = 100.0
margin_right = 0.0
margin_bottom = 0.0
margin_left = 0.0


[osd]
position = "right"


[dock]
position = "bottom"
monitors = "primaryonly"
visibility = "always-visible"
hover_effect = "lift"
icon_size = 40.0
pinned = ["firefox.desktop"]


[control_center.power_actions]
sleep = "systemctl suspend"
reboot = "systemctl reboot"
poweroff = "systemctl poweroff"

Dock

Section titled “Dock”

The [dock] section configures the pinned and running application dock.

[dock]
position = "bottom"       # "top", "bottom", "left", or "right"
monitors = "primaryonly"  # "primaryonly" or "all"
visibility = "always-visible"
hover_effect = "lift"     # "none", "lift", "magnify", "glow", or "magnify-lift"
icon_size = 40.0
pinned = ["firefox.desktop"]

visibility accepts:

  • "always-visible": the dock never hides.
  • "intelligent-hide": the dock hides when focus leaves its monitor and reappears at its edge.
  • "dodge-windows": the dock hides when the focused window overlaps it. On compositors without window geometry, it uses intelligent-hide behavior instead.

See the individual reference pages for details on each section: