Skip to content
Documentation menu

Appearance

Set your terminal theme and font, tune the cursor and window, and find the rest of Termio’s settings — all in a familiar macOS settings window.

Markdown

Open Settings with ⌘,. It’s a standard macOS settings window with a sidebar of tabs; Appearance is where the terminal’s look lives.

Theme

Termio uses Ghostty-format themes, so anything from the wider Ghostty theme ecosystem works. Pick a light and a dark theme from Settings ▸ Appearance and Termio follows the system between them.

The two slots list the themes you have — Termio’s own canvas plus whatever is in your Themes folder — not a catalog of hundreds you never chose.

Termio Appearance settings with System, Light, and Dark modes and separate light and dark terminal theme slots

If you already use Ghostty, there’s nothing to pick on a fresh install: Termio reads your ~/.config/ghostty/config on first launch and starts with the font and theme you chose there.

Getting more themes

Browse Themes… opens a store of 69 well-known schemes — Dracula, Catppuccin, Gruvbox, Rose Pine, Solarized, and the rest — each one picked to stay readable through a working day, and no two unrelated ones close enough to arrive twice under different names. Flavors of one family are the exception: all four Catppuccins are there, because the flavor name is exactly what its users pick between. Install writes that theme into your Themes folder and selects it in the light or dark slot it belongs to. Nothing is downloaded: the schemes ship inside Termio.

If a file of the same name is already in your Themes folder, Install stops and asks before replacing it — a theme you dropped in yourself is yours. Remove deletes the file, and asks first if you have edited it.

To switch between the themes you have with your terminals as the preview, open the Command Palette (⇧⌘P) and pick Change Theme… — arrowing through the list restyles your open terminals live, Return keeps the theme, Escape puts it back.

The Change Theme palette over a Termio terminal with Catppuccin Latte selected and applied

To add a theme the store doesn’t carry, drop a Ghostty-format theme file into:

~/Library/Application Support/termio/Themes/

The Open Themes Folder button takes you straight there, and Reload picks up new files without a restart.

Font

Choose any monospaced font installed on your Mac, set its size, and toggle Thicken glyphs if you like a heavier weight. Font size also has live shortcuts while you work — ⌘= to grow, ⌘- to shrink, ⌘0 to reset.

Cursor & window

The same tab tunes the cursor (block, bar, or underline; steady or blinking) and the window itself — padding around the terminal, and background opacity and blur for a translucent window over your desktop. The app’s own chrome lives here too: the sidebar’s font and density.

The rest of Settings

The other tabs cover the rest of the app:

  • General — language, task notifications, the GitHub integration behind the inspector’s Issues pane, and a Privacy switch for anonymous daily usage statistics.
  • Terminal — scrollback history and text selection.
  • Devices — this Mac and every machine you reach from it, one row each, drilling into how that machine is reached and what Termio has installed on it. See Devices.
  • Workspaces — every workspace with the machine it’s on, and the place to rename or remove one. See Workspaces.
  • Keyboard — rebind any shortcut; see Keyboard shortcuts.
  • Agents — add agents, enable them, and turn on session control. The pane carries a machine scope, because where an agent’s CLI lives is a fact about one machine.
  • Usage — token usage for agents you sign in to (Claude Code, Codex). Termio reuses each CLI’s own credentials to show you where you stand against your limits; it stores nothing of its own.
  • Mobile — pair your iPhone with a machine, and publish an address it can reach. See the iPhone companion.
  • Community — where to find the project: GitHub, Discord, and the WeChat group.

Settings that can differ per machine say which machine they mean, with a picker at the top of the pane. What you change there is what that machine gets.

Docs