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.
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.