Skip to main content
Customize Termy’s visual appearance including theme, fonts, window transparency, and padding.

​
Theme

​
theme
string
default:"termy"
The active color scheme name. Use the built-in termy theme or import custom themes.Change themes at runtime with Cmd+P → “Switch Theme” or via the Settings UI.
theme = termy

​
Available Themes

Termy includes several built-in themes. You can also import custom themes from JSON files:
  1. Open Command Palette (Cmd+P or Ctrl+P)
  2. Search for “Import Colors”
  3. Select a theme JSON file
See Colors for details on creating custom themes.

​
Font

​
font_family
string
default:"JetBrains Mono"
The font family used for terminal text. Must be a monospace font installed on your system.
​
font_size
number
default:"14"
Terminal font size in pixels. You can also zoom in/out at runtime with Cmd+ and Cmd-.
font_family = JetBrains Mono
font_size = 14

​
Font Recommendations

Popular monospace fonts that work well with Termy:
  • JetBrains Mono (default) - Great ligatures and readability
  • Cascadia Code - Microsoft’s modern coding font
  • Fira Code - Popular font with extensive ligatures
  • SF Mono - macOS system monospace font
  • Menlo - Classic macOS font
  • Consolas - Windows system font
Make sure the font is installed system-wide before adding it to your config. Termy will fall back to the default if the font is not found.

​
Window Transparency

​
background_opacity
number
default:"1"
Window background opacity level from 0.0 (fully transparent) to 1.0 (fully opaque).
​
background_blur
boolean
default:"false"
Enable blur effect for transparent backgrounds. Only visible when background_opacity is less than 1.0.
Platform support varies. Works best on macOS.
# 95% opacity with blur effect
background_opacity = 0.95
background_blur = true

​
Transparency Examples

# Fully opaque (default)
background_opacity = 1
background_blur = false

# Subtle transparency
background_opacity = 0.95
background_blur = true

# Heavy transparency (for overlays)
background_opacity = 0.8
background_blur = true

​
Padding

​
padding_x
number
default:"12"
Left and right padding around terminal content in pixels.
​
padding_y
number
default:"8"
Top and bottom padding around terminal content in pixels.
padding_x = 12
padding_y = 8

​
Padding Tips

  • Increase padding for a more spacious look
  • Decrease padding to maximize terminal space
  • Use symmetrical padding for balance
# Minimal padding
padding_x = 4
padding_y = 4

# Generous padding
padding_x = 20
padding_y = 16

​
Window Dimensions

​
window_width
number
default:"1280"
Default startup window width in pixels. Only applies to new windows.
​
window_height
number
default:"820"
Default startup window height in pixels. Only applies to new windows.
window_width = 1280
window_height = 820
Window dimension settings only affect newly created windows, not existing ones.

​
UI Customization

​
show_termy_in_titlebar
boolean
default:"true"
Show or hide the “Termy” branding in the window titlebar.
​
command_palette_show_keybinds
boolean
default:"true"
Show keyboard shortcut badges in command palette rows.
show_termy_in_titlebar = true
command_palette_show_keybinds = true

​
Pane Focus Effects

​
pane_focus_effect
string
default:"soft_spotlight"
How inactive panes are visually dimmed when a pane is active. Controls the dimming algorithm.
​
pane_focus_strength
number
default:"0.6"
Strength of active pane emphasis from 0.0 (no dimming) to 2.0 (heavy dimming).
pane_focus_effect = soft_spotlight
pane_focus_strength = 0.6

​
Focus Effect Examples

# Subtle dimming
pane_focus_effect = soft_spotlight
pane_focus_strength = 0.4

# Strong dimming
pane_focus_effect = soft_spotlight
pane_focus_strength = 1.2

# No dimming
pane_focus_strength = 0.0

​
Complete Example

# Theme and colors
theme = tokyo-night

# Font settings
font_family = Cascadia Code
font_size = 16

# Window transparency
background_opacity = 0.95
background_blur = true

# Padding
padding_x = 16
padding_y = 12

# Window size
window_width = 1440
window_height = 900

# UI preferences
show_termy_in_titlebar = false
command_palette_show_keybinds = true

# Pane focus
pane_focus_effect = soft_spotlight
pane_focus_strength = 0.8

Build docs developers (and LLMs) love

Get started for freeTalk to us