Skip to main content
otter-settings is the default way to configure Otter Shell. Tabs for every app, a theme browser, and drag-and-drop bar layout. Prefer $EDITOR? Same files either way.

Usage

otter-settings
Launch from otter-launcher or bind a compositor hotkey (for example Super+Comma).
Writes to ~/.config/otter-shell/*.conf. Running apps reload via inotify after Apply.

Why use otter-settings

BenefitDetail
No syntaxToggles, dropdowns, color swatches, and steppers instead of key-value files
SearchFind fields by key, label, value, or section
Bar layoutDrag widget chips instead of editing layout_left strings
ThemesPreview all 12 presets before applying
Safe savesKeeps comments, field order, and custom fields

Config files managed

TabFile
Barotter-bar.conf
Launcherotter-launcher.conf
Notificationsnotifications.conf
Wallpaperotter-wallpaper.conf
OSDotter-osd.conf
Jadeotter-jade.conf
Logoutotter-logout.conf
Polkitotter-polkit.conf
Lockotter-lock.conf
Idleotter-idle.conf
Terminalotter-term.conf
Recorderotter-rec.conf
Voiceotter-vox.conf
Themetheme.conf
Also includes drag-and-drop bar layout, custom bar buttons, and clipboard paste (Ctrl+V) in text fields via Wayland data device.

What otter-settings does not configure

Compositor hotkeys (launcher, screenshot, lock) belong in your Wayland compositor config. See Keybinds. otter-screenshot has no persistent config file. CLI flags only.

Theme presets

Otter Shell, Otter Shell Islands, Catppuccin variants, Nord, Gruvbox, Dracula, Tokyo Night, and One Dark. See Themes for color token details.