Muxie Get Muxie
How-to guides How-to guide

Customize the terminal

Set a theme and accent, pick a color scheme and font, and tune the cursor, ligatures, and bell.

You can adjust how the terminal looks and feels under Settings. The keys below are the underlying configuration names.

Theme and accent

  • theme — the app theme. Options are system, dark, black, mocha, muxie, and muxie-light.
  • accentColor — a hex color used for accents in the UI.

Terminal colors

terminalColorScheme controls the colors inside the terminal:

  • follow-theme (default) — use the terminal colors that come with the app theme.
  • preset:<slug> — a bundled preset. Hundreds of ghostty and iTerm2 color presets are bundled.
  • custom:<slug> — a custom scheme. You can import, edit, and delete your own custom schemes.

Font

  • fontFamily — the terminal font. The default is the bundled “Noto Sans Mono”.
  • fontSize — 8 to 32, default 13.
  • fontLigatures — off by default.
  • showAllFonts — show all installed fonts in the picker instead of monospace-only fonts.

Tip: You can also change the font size live with Ctrl+= to grow, Ctrl+- to shrink, and Ctrl+0 to reset.

Cursor, scrollbar, and bell

  • cursorStyle — block, bar, or underline.
  • cursorBlink — whether the cursor blinks.
  • showScrollbar — whether the scrollbar is visible.
  • terminalBell — none, visual, or sound.

Titlebar

customTitlebar draws a Muxie-colored titlebar.

Heads up: Changing customTitlebar requires a restart to take effect.

For more on how Muxie renders the terminal, see The terminal engine. For every setting in one place, see the Settings reference.