Skip to main content
All Otter Shell apps share one theme via otter-theme. The Theme tab in otter-settings previews all 12 built-in presets and writes changes on Apply.
otter-settings
Changes land in ~/.config/otter-shell/theme.conf. Running apps that watch the file pick them up.
Stick with otter-settings unless you need keys the UI does not expose. It keeps comments and field order on save.

Theme config file

Edit ~/.config/otter-shell/theme.conf directly if you prefer. otter-bar, otter-transcribe, and otter-term read it at startup and on change.

Terminal colors

Set otter-term’s 16-color palette and UI chrome in otter-settings under Terminal, or in ~/.config/otter-shell/otter-term.conf:
colors_background = "#1e1e2e"
colors_foreground = "#cdd6f4"
colors_cursor     = "#f5e0dc"
colors_selection  = "#313244"

# 16-color palette
colors_black   = "#45475a"
colors_red     = "#f38ba8"
colors_green   = "#a6e3a1"
colors_yellow  = "#f9e2af"
colors_blue    = "#89b4fa"
colors_magenta = "#f5c2e7"
colors_cyan    = "#94e2d5"
colors_white   = "#bac2de"
Terminal colors hot-reload on save.

App-level color overrides

Apps can override the shared theme with their own color keys. In otter-transcribe’s Transcribe tab (or otter-transcribe.conf):
background_color  = ""
border_color      = ""
graph_color       = ""
graph_peak_color  = ""
text_color        = ""
Empty string "" inherits from the theme. Set a hex color to override for that app only.

Font

Default terminal font: IoskeleyMono Nerd Font, bundled in otter-shell-fonts at /usr/share/fonts/otter-shell/. Change it in otter-settings under Terminal, or in otter-term.conf:
font_family    = "JetBrains Mono"
font_size      = 14
font_dpi_aware = true
font_dpi_aware = true scales font and padding on high-DPI displays. Empty font_family = "" falls back to the bundled Nerd Font.

Built-in presets

In the otter-settings theme browser: Otter Shell, Otter Shell Islands, Catppuccin (Mocha/Latte/Frappe/Macchiato), Nord, Gruvbox, Dracula, Tokyo Night, One Dark.