Oxide Terminal / docs
Docs / Reference / Themes

Themes

Twenty-five built-in presets, a picker with live preview, and per-color overrides for when a preset is nearly right.

The theme picker

cmd-alt-t (or Oxide → Select Theme…) opens a modal list. j/k — or the arrows, or ctrl-n/ctrl-p — move through it, repainting the whole window as you go, so you're judging the theme rather than a row of swatches. enter keeps it, esc puts back what you had.

Confirming writes preset = "…" into the [colors] section of your config file, preserving the rest of the file's formatting and comments.

Confirming replaces the entire [colors] block — individual color overrides are dropped, because they'd quietly defeat the theme you just picked. If you keep hand-tuned colors, edit preset in the file directly instead. With follow_system on, the picker instead sets only preset_dark or preset_light — whichever the Mac is showing right now — and leaves the rest of the block alone.

Following the system appearance

Two presets, and macOS decides which one is up: the moment the appearance flips, so does Oxide, in every pane and the chrome around them.

[colors]
follow_system = true
preset_dark   = "catppuccin-mocha"
preset_light  = "catppuccin-latte"

Either variant falls back to preset when unset; with nothing but follow_system = true, dark gets the default palette and light gets catppuccin-latte. Per-color overrides are shared: a cursor you set applies on top of whichever preset is active, so pick ones that read on both.

The presets

catppuccin-mocha
catppuccin-latte
gruvbox-dark
tokyonight
dracula
nord
solarized-dark
oxide
ethereal
everforest
flexoki-light
hackerman
kanagawa
last-horizon
lumon
lupine
matte-black
miasma
osaka-jade
retro-82
ristretto
rose-pine-dawn
solitude
vantablack
white
PresetNotes
catppuccin-mochaThe default when no preset is set. Soft pastels on near-black.
catppuccin-latteLight. The fallback when follow_system needs a light preset.
gruvbox-darkWarm, retro, high contrast.
tokyonightCool blues and violets.
draculaSaturated colors on slate.
nordMuted arctic blues.
solarized-darkThe classic low-contrast teal.
oxideRust-toned — the palette this whole site is painted in.
etherealPeach text on deep midnight blue, with dusty pastels.
everforestSoft greens and warm beige on slate. Easy on the eyes.
flexoki-lightLight. Inky colors on warm paper.
hackermanGreen-on-black terminal nostalgia, neon everything.
kanagawaMuted ink-wash tones after Hokusai's wave.
last-horizonNear-black with dusty rose and steel blue.
lumonAll blues, all the time. Your outie approves.
lupineLight. Vivid violets and blues on off-white.
matte-blackCharcoal with amber and brick accents.
miasmaEarthy olive and brown on dark grey.
osaka-jadeDeep jade greens with a hot red accent.
retro-82Eighties sunset: orange and teal on navy.
ristrettoMonokai Pro's coffee-brown variant.
rose-pine-dawnLight. Rosé Pine's Dawn variant (Omarchy ships it as rose-pine).
solitudeCool desaturated greys on near-black.
vantablackGreyscale on pure black.
whiteLight. Greyscale on pure white.
[colors]
preset = "gruvbox-dark"

Overriding individual colors

Any color you name wins over the preset, so you can start from one and adjust. Values are #rgb or #rrggbb.

[colors]
preset       = "nord"
background   = "#000000"   # darker than Nord's own
cursor       = "#e2725b"
selection_bg = "#4a3428"

The full set of keys:

KeysUsed for
background, foregroundThe default cell colors, the drawer, and the status bar, which derive their shades from these.
cursorThe cursor, whatever its shape (see [cursor]). Copy mode's cursor is ANSI yellow.
selection_bgSelected text, and the selected row in the drawer.
selection_fgText inside a selection. Unset by default, which keeps each cell's own colour; set it when selection_bg clashes with coloured output.
black … whiteANSI 0–7.
bright_black … bright_whiteANSI 8–15.

Colors reload live: save the file and the window repaints, no restart and no new tab. An unknown preset name doesn't break anything — Oxide keeps the current theme and shows a toast listing the valid names.

Transparency and blur

Not part of [colors], but the same conversation:

[window]
opacity = 0.92
blur    = true

opacity applies to the window background; blur frosts what's behind it. Text stays fully opaque.

What the UI derives

The drawer, tab bar, status bar, and search box aren't separately themeable — they're computed from the terminal palette. The drawer and status bar sit a shade darker than background, text is foreground dimmed toward it, directory icons use ANSI blue, as does the workspace chip, and the git branch is green until the tree goes dirty and then yellow. Change the palette and the chrome follows.