Configuration reference

Configuration file locations

Cretty stores its configuration in the platform-specific path below. The filename is config.toml.

Platform	Path
macOS	`~/Library/Application Support/com.cretezy.cretty/config.toml`
Linux	`$XDG_CONFIG_HOME/cretty/config.toml`, or `~/.config/cretty/config.toml` when `XDG_CONFIG_HOME` is unset or relative
Windows	`%APPDATA%/cretezy/cretty/config/config.toml`

Settings can be changed through Cretty’s Settings page or in config.toml. Cretty preserves hand-authored comments, formatting, unknown keys, and explicit defaults when editing the file.

Terminal

`terminal.bell_flash`

Type: boolean
Default: true
Description: Flash inactive tabs when the terminal rings its bell.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
bell_flash = true

`terminal.borderless_terminal`

Type: boolean
Default: true
Description: Remove the terminal’s outer border.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
borderless_terminal = true

`terminal.close_confirmation`

Type: string
Default: running_command
Description: Configuration value for terminal.close_confirmation.
Constraints: one of always, running_command, never

Example:

[terminal]
close_confirmation = "always"

`terminal.close_tab_on_exit`

Type: boolean
Default: true
Description: Close a tab when its shell exits.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
close_tab_on_exit = true

`terminal.fill_viewport_with_terminal`

Type: boolean
Default: true
Description: Fill the viewport with terminal content.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
fill_viewport_with_terminal = true

`terminal.font.family`

Type: string
Default: monospace
Description: Terminal font family.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal.font]
family = "monospace"

`terminal.font.size`

Type: number
Default: 16.0
Description: Terminal font size in points (6–36).
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal.font]
size = 16.0

`terminal.hyperlinks_enabled`

Type: boolean
Default: true
Description: Enable hyperlink detection.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
hyperlinks_enabled = true

`terminal.inherit_working_directory`

Type: boolean
Default: true
Description: Inherit the active tab’s working directory when creating a tab.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
inherit_working_directory = true

`terminal.ligatures`

Type: boolean
Default: false
Description: Enable font ligatures.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
ligatures = false

`terminal.nerd_font_fallback`

Type: boolean
Default: true
Description: Use embedded Nerd Font fallback glyphs.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
nerd_font_fallback = true

`terminal.restore_session`

Type: boolean
Default: true
Description: Restore all windows, nested groups, tabs, titles, and working directories on startup.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
restore_session = true

`terminal.scroll_on_keystroke`

Type: boolean
Default: true
Description: Scroll to the bottom after typing.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
scroll_on_keystroke = true

`terminal.scroll_on_output`

Type: boolean
Default: false
Description: Scroll to the bottom when output arrives.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
scroll_on_output = false

`terminal.scrollback_limit`

Type: integer
Default: 10000
Description: Number of lines retained in terminal scrollback (100–100,000).
Constraints: minimum 0

Example:

[terminal]
scrollback_limit = 10000

`terminal.shell.args`

Type: array of string
Default: []
Description: Arguments passed to the shell.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal.shell]
args = ["-l"]

`terminal.shell.program`

Type: string
Default: $SHELL, or /bin/sh when SHELL is unset
Description: Executable used for new tabs.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal.shell]
program = "/bin/sh"

`terminal.smooth_scrolling`

Type: boolean
Default: true
Description: Animate terminal scrolling.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
smooth_scrolling = true

`terminal.terminal_horizontal_margin`

Type: number
Default: 4.0
Description: Horizontal terminal cell margin in pixels (0–100).
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
terminal_horizontal_margin = 4.0

`terminal.terminal_vertical_margin`

Type: number
Default: 2.0
Description: Vertical terminal cell margin in pixels (0–100).
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
terminal_vertical_margin = 2.0

`terminal.theme`

Type: string
Default: Dark
Description: Built-in or custom terminal theme name.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[terminal]
theme = "Dark"

`terminal.theme_overrides.background`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
background = "#1e1e2e"

`terminal.theme_overrides.bright_black`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_black = "#1e1e2e"

`terminal.theme_overrides.bright_blue`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_blue = "#1e1e2e"

`terminal.theme_overrides.bright_cyan`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_cyan = "#1e1e2e"

`terminal.theme_overrides.bright_green`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_green = "#1e1e2e"

`terminal.theme_overrides.bright_magenta`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_magenta = "#1e1e2e"

`terminal.theme_overrides.bright_red`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_red = "#1e1e2e"

`terminal.theme_overrides.bright_white`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_white = "#1e1e2e"

`terminal.theme_overrides.bright_yellow`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
bright_yellow = "#1e1e2e"

`terminal.theme_overrides.cursor`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
cursor = "#1e1e2e"

`terminal.theme_overrides.foreground`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
foreground = "#1e1e2e"

`terminal.theme_overrides.normal_black`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_black = "#1e1e2e"

`terminal.theme_overrides.normal_blue`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_blue = "#1e1e2e"

`terminal.theme_overrides.normal_cyan`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_cyan = "#1e1e2e"

`terminal.theme_overrides.normal_green`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_green = "#1e1e2e"

`terminal.theme_overrides.normal_magenta`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_magenta = "#1e1e2e"

`terminal.theme_overrides.normal_red`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_red = "#1e1e2e"

`terminal.theme_overrides.normal_white`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_white = "#1e1e2e"

`terminal.theme_overrides.normal_yellow`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
normal_yellow = "#1e1e2e"

`terminal.theme_overrides.selection_background`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
selection_background = "#1e1e2e"

`terminal.theme_overrides.selection_foreground`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal.theme_overrides]
selection_foreground = "#1e1e2e"

Appearance

`appearance.collapsed_sidebar_reveal_width`

Type: number
Default: 20.0
Description: Width in pixels of the edge zone that reveals a collapsed sidebar (8–64).
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
collapsed_sidebar_reveal_width = 20.0

`appearance.collapsible_sidebar`

Type: boolean
Default: false
Description: Allow the sidebar to collapse.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
collapsible_sidebar = false

`appearance.compact_sidebar`

Type: boolean
Default: false
Description: Use compact rows in the sidebar tree.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
compact_sidebar = false

`appearance.cycle_tabs_within_group`

Type: boolean
Default: false
Description: Restrict Ctrl+Tab cycling to tabs in the same group.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
cycle_tabs_within_group = false

`appearance.font`

Type: string
Default: Inter
Description: Application interface font family.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
font = "Inter"

`appearance.high_contrast`

Type: boolean
Default: false
Description: Increase interface text and border contrast without changing terminal colors.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
high_contrast = false

`appearance.line_height`

Type: number
Default: 1.15
Description: Terminal line-height multiplier (1.0–2.0).
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
line_height = 1.15

`appearance.nesting_indent`

Type: string
Default: compact
Description: Horizontal spacing between nesting levels, independent of list density.
Constraints: one of normal, compact

Example:

[appearance]
nesting_indent = "normal"

`appearance.nesting_lines`

Type: string
Default: off
Description: Connect nested rows with curved branches, square branches, guides, or no lines.
Constraints: one of curved, square, guides, off

Example:

[appearance]
nesting_lines = "curved"

`appearance.new_tab_position`

Type: string
Default: bottom
Description: Place the New tab action at the bottom or top of the list, or hide it.
Constraints: one of hidden, bottom, top

Example:

[appearance]
new_tab_position = "hidden"

`appearance.prompt_name_on_new_group`

Type: boolean
Default: false
Description: Prompt for a name when creating a group.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
prompt_name_on_new_group = false

`appearance.prompt_name_on_new_tab`

Type: boolean
Default: false
Description: Prompt for a name when creating a tab.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
prompt_name_on_new_tab = false

`appearance.reduced_motion`

Type: boolean
Default: false
Description: Disable interface transitions, rotating progress indicators, and bell flashes.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
reduced_motion = false

`appearance.scale_factor`

Type: number
Default: unset (automatic)
Description: Display scale factor (0.5–2.5); omit to use automatic scaling.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
scale_factor = 1.0

`appearance.selected_tab_highlight`

Type: string
Default: full_width
Description: Highlight the full row width or follow its nesting indentation.
Constraints: one of full_width, follows_indent

Example:

[appearance]
selected_tab_highlight = "full_width"

`appearance.show_command_icon`

Type: boolean
Default: true
Description: Show a command icon in tab labels.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
show_command_icon = true

`appearance.show_tab_information`

Type: boolean
Default: false
Description: Show contextual information in tab labels.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
show_tab_information = false

`appearance.sidebar_width`

Type: number
Default: 320.0
Description: Default sidebar width for new windows in pixels (220–440).
Constraints: clamped to 220–440

Example:

[appearance]
sidebar_width = 320.0

`appearance.style`

Type: string
Default: round
Description: Sidebar corner style.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
style = "round"

`appearance.tab_information`

Type: string
Default: pwd
Description: Configuration value for appearance.tab_information.
Constraints: one of pwd, current_command

Example:

[appearance]
tab_information = "pwd"

`appearance.theme`

Type: string
Default: dark
Description: Application chrome theme name.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
theme = "dark"

`appearance.theme_overrides.background`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[appearance.theme_overrides]
background = "#1e1e2e"

`appearance.theme_overrides.danger`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[appearance.theme_overrides]
danger = "#1e1e2e"

`appearance.theme_overrides.foreground`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[appearance.theme_overrides]
foreground = "#1e1e2e"

`appearance.theme_overrides.muted`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[appearance.theme_overrides]
muted = "#1e1e2e"

`appearance.theme_overrides.primary`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[appearance.theme_overrides]
primary = "#1e1e2e"

`appearance.theme_overrides.success`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[appearance.theme_overrides]
success = "#1e1e2e"

`appearance.theme_overrides.warning`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[appearance.theme_overrides]
warning = "#1e1e2e"

`appearance.use_terminal_bg_for_app`

Type: boolean
Default: false
Description: Use the terminal background for application chrome.
Constraints: Use the documented type; omitted values keep the effective default.

Example:

[appearance]
use_terminal_bg_for_app = false

Keybindings

Keybindings are configured under [keybinds]. Values are case-insensitive combinations of ctrl, alt, shift, and super/cmd, followed by a key. Use none to unbind an action.

Action	TOML key	macOS default	Linux/Windows default
Copy selection	`copy_selection`	`cmd+c`	`ctrl+shift+c`
Paste clipboard	`paste_clipboard`	`cmd+v`	`ctrl+shift+v`
Search	`toggle_search`	`cmd+f`	`ctrl+shift+f`
Copy raw screen	`copy_raw_screen`	`cmd+p`	`ctrl+shift+p`
Copy terminal screenshot	`copy_terminal_screenshot`	`shift+cmd+o`	`ctrl+shift+o`
Save terminal screenshot	`save_terminal_screenshot`	`alt+shift+cmd+o`	`ctrl+alt+shift+o`
Command palette	`command_palette`	`shift+cmd+p`	`ctrl+shift+k`
Switch tab across windows	`switch_tab`	`shift+cmd+l`	`ctrl+shift+l`
Reopen closed tabs or groups	`reopen_closed`	`shift+cmd+t`	`ctrl+shift+z`
Next tab	`next_tab`	`ctrl+tab`	`ctrl+tab`
Previous tab	`previous_tab`	`ctrl+shift+tab`	`ctrl+shift+tab`
New tab	`new_tab`	`cmd+t`	`ctrl+shift+t`
New group	`new_group`	`cmd+n`	`ctrl+shift+n`
New window	`new_window`	`shift+cmd+n`	`ctrl+alt+n`
Quit and save all windows	`quit`	`cmd+q`	`ctrl+shift+q`
Close tab	`close_tab`	`cmd+w`	`ctrl+shift+w`
Close group	`close_group`	`alt+cmd+w`	`ctrl+alt+shift+w`
Rename tab	`rename_tab`	`cmd+r`	`ctrl+shift+r`
Rename group	`rename_group`	`alt+cmd+r`	`ctrl+alt+shift+r`
Zoom in	`zoom_in`	`cmd+=`	`ctrl+shift+=`
Zoom out	`zoom_out`	`cmd+-`	`ctrl+shift+-`
Scroll up one page	`scroll_page_up`	`cmd+page_up`	`ctrl+shift+page_up`
Scroll down one page	`scroll_page_down`	`cmd+page_down`	`ctrl+shift+page_down`
Scroll to start of scrollback	`scroll_to_scrollback_start`	`cmd+home`	`ctrl+shift+home`
Scroll to end of scrollback	`scroll_to_scrollback_end`	`cmd+end`	`ctrl+shift+end`
Focus sidebar	`focus_sidebar`	`cmd+s`	`ctrl+shift+s`
Toggle collapsible sidebar	`toggle_sidebar`	`cmd+b`	`ctrl+shift+b`
Show/hide window (global)	`toggle_window_visibility`	`cmd+f12`	`ctrl+f12`

Example:

[keybinds]
copy_selection = "ctrl+alt+c"
zoom_out = "none"

Custom application themes

Define a custom theme as [app_themes.<name>], then select it with appearance.theme. Every field is optional. Color fields accept six-digit hexadecimal values.

`app_themes.<name>.background`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
background = "#1e1e2e"

`app_themes.<name>.danger`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
danger = "#1e1e2e"

`app_themes.<name>.foreground`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
foreground = "#1e1e2e"

`app_themes.<name>.muted`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
muted = "#1e1e2e"

`app_themes.<name>.name`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
name = "My theme"

`app_themes.<name>.primary`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
primary = "#1e1e2e"

`app_themes.<name>.success`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
success = "#1e1e2e"

`app_themes.<name>.warning`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[app_themes.my_theme]
warning = "#1e1e2e"

Custom terminal themes

Define a custom theme as [terminal_themes.<name>], then select it with terminal.theme. Every field is optional. Color fields accept six-digit hexadecimal values.

`terminal_themes.<name>.background`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
background = "#1e1e2e"

`terminal_themes.<name>.bright_black`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_black = "#1e1e2e"

`terminal_themes.<name>.bright_blue`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_blue = "#1e1e2e"

`terminal_themes.<name>.bright_cyan`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_cyan = "#1e1e2e"

`terminal_themes.<name>.bright_green`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_green = "#1e1e2e"

`terminal_themes.<name>.bright_magenta`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_magenta = "#1e1e2e"

`terminal_themes.<name>.bright_red`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_red = "#1e1e2e"

`terminal_themes.<name>.bright_white`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_white = "#1e1e2e"

`terminal_themes.<name>.bright_yellow`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
bright_yellow = "#1e1e2e"

`terminal_themes.<name>.cursor`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
cursor = "#1e1e2e"

`terminal_themes.<name>.foreground`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
foreground = "#1e1e2e"

`terminal_themes.<name>.name`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
name = "My theme"

`terminal_themes.<name>.normal_black`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_black = "#1e1e2e"

`terminal_themes.<name>.normal_blue`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_blue = "#1e1e2e"

`terminal_themes.<name>.normal_cyan`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_cyan = "#1e1e2e"

`terminal_themes.<name>.normal_green`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_green = "#1e1e2e"

`terminal_themes.<name>.normal_magenta`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_magenta = "#1e1e2e"

`terminal_themes.<name>.normal_red`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_red = "#1e1e2e"

`terminal_themes.<name>.normal_white`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_white = "#1e1e2e"

`terminal_themes.<name>.normal_yellow`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
normal_yellow = "#1e1e2e"

`terminal_themes.<name>.selection_background`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
selection_background = "#1e1e2e"

`terminal_themes.<name>.selection_foreground`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
selection_foreground = "#1e1e2e"

`terminal_themes.<name>.terminal_background`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
terminal_background = "#1e1e2e"

`terminal_themes.<name>.terminal_foreground`

Type: string
Default: unset
Description: Optional color value for this theme.
Constraints: six-digit hexadecimal color when set

Example:

[terminal_themes.my_theme]
terminal_foreground = "#1e1e2e"

Minimal example

[terminal]
theme = "tokyo_night"
scrollback_limit = 20000

[terminal.font]
family = "JetBrains Mono"
size = 14.0

[appearance]
theme = "dark"
font = "Inter"
compact_sidebar = false
sidebar_width = 360.0

[keybinds]
new_tab = "ctrl+alt+t"