Skip to content

Themes ​

Pick one in Settings → Appearance (ctrl+b s, or Settings in the activity bar): click a theme and it applies at once; ↶ Back to … returns to the one you had. It saves [theme] name in config.toml and every part of Ghosted recolours straight away.

When the window shows a machine whose Ghosted has no Settings view (older, or Windows), ctrl+b s opens the window's own Settings instead: moving through its theme list with the arrow keys previews each one; choose one to keep it.

18 built-in themes: catppuccin (default), catppuccin-latte, terminal (your terminal's own colours), tokyo-night, tokyo-night-day, dracula, nord, gruvbox, gruvbox-light, one-dark, one-light, solarized, solarized-light, kanagawa, kanagawa-lotus, rose-pine, rose-pine-dawn, vesper.

The terminal window ​

While Ghosted is open, the terminal it runs in (Ghostty, iTerm2, kitty…) takes the theme's background and foreground colours, and gets its own back when Ghosted closes. To keep your terminal's colours:

toml
[theme]
terminal_colors = false

Your own themes ​

One file per theme in ~/.config/ghosted/themes/<name>.toml. It starts from a built-in theme and changes only what you list:

toml
base = "tokyo-night"   # any built-in; default catppuccin

accent = "#ff9e64"
bar_bg = "#16161e"
card_bg = "#1f2335"
lane1 = "#7aa2f7"

It shows up in the Settings list under its file name. The same keys work in [theme.custom] (and [theme.custom.dark] / [theme.custom.light]) in config.toml to adjust whichever theme is active.

Colour names ​

Base colours: accent panel_bg sidebar_bg active_row_bg selection_bg surface0 surface1 surface_dim overlay0 overlay1 text subtext0 mauve green yellow red blue teal peach.

Colours named by their job. Leave one out and it is worked out from the base:

NameWhat it coloursDefault
background, foregroundthe terminal window Ghosted runs insurface_dim, text
bar_bgactivity barsidebar_bg
popup_bg, tab_bar_bgpopups, tab barpanel_bg
card_bg, card_hovercards and buttons (the views)surface0, surface1
mutedquiet textoverlay0
diff_added, diff_removedchanged linesgreen, red
diff_added_bg, diff_removed_bgchanged line backgroundsgreen / red faded into surface_dim
lane1..lane8Git Graph branch lanesblue green peach mauve teal yellow red accent
ansi0..ansi15the 16 terminal colours inside panesfrom the base colours

Colours are #rrggbb, #rgb, rgb(r, g, b), a colour name, or reset (the terminal's own).

Panes ​

Shells and agents keep your terminal's colours unless you turn this on:

toml
[theme]
panes = true   # recolour the 16 terminal colours with ansi0..ansi15

For plugins ​

Ghosted writes the resolved theme to the file named by GHOSTED_THEME_FILE (~/.local/state/ghosted/theme.json) whenever it changes: {"name", "available", "colors": {name: "#rrggbb" | "reset" | "ansi:N"}}, with every name above filled in.

Made by Megasupersoft. Free to use; not open source. Built on herdr (Apache-2.0).