Presets and loading

Bundled presets

12 comptime presets in presets.zig:

Preset	Style
Otter Shell	Default matte continuous bar
Otter Shell Islands	Grouped floating bar
Catppuccin Mocha / Latte / Frappe / Macchiato	Catppuccin family
Nord	Arctic blue dark
Gruvbox Dark / Light	Retro
Dracula	Purple dark
Tokyo Night	Cool blue dark
One Dark	Atom-inspired dark

const presets = @import("otter_theme").presets;

if (presets.findPreset("Nord")) |preset| {
    const theme = preset.theme;
}

Settings writes built-in preset colors to preset-colors.conf. otter-theme-gen writes wallpaper colors to generated-colors.conf. Root theme.conf selects one of those layers with an ordered import and keeps explicit user overrides separate.

Loading

Root file selection:

~/.config/otter-shell/theme.conf
/etc/otter-shell/theme.conf
No root file, so compiled Current defaults stand alone

Once a root is selected, values resolve from compiled Current defaults, then profile and density imports, optional color layer, and finally explicit root fields.

const theme = otter_theme.loadTheme(allocator);

var buf: [std.fs.max_path_bytes]u8 = undefined;
if (otter_theme.getThemeConfigPath(&buf)) |path| {
    // watch with inotify for hot-reload
}

loadThemeFromPath parses a specific file without the fallback chain.

Example theme.conf

import = "profiles/current.conf"
import = "profiles/density-standard.conf"
import = "generated-colors.conf"

# Explicit root overrides load last.
colors_accent = "#89b4faff"

ThemeWatcher watches the root file and every imported path. It also catches an imported generated-colors.conf created after startup. A failed reload keeps the previous valid theme.

Getting Started

Libraries

Bundled presets

Loading

Example theme.conf

​Bundled presets

​Loading

​Example theme.conf

Bundled presets

Loading

Example theme.conf