TerminalSettings

Koru Terminal's appearance.

Roaming, which is a change: these lived in this machine's windows.conf row, beside the geometry, purely because the terminal had one file. How a terminal looks is a preference about the person, not about the monitor it happened to be opened on.

Read tolerantly, as [GlobalSettings] is: an unknown field is ignored on the read; the [TerminalPatch] that writes it refuses one.

Type object

Shape

Field	Type	Description
themerequired	ThemeChoice	`theme=` in `preferences.conf`, and the terminal row's `theme=`. Matches `koru_draw::theme::ThemePreference`: case-sensitive, because that is what the existing parser does and a file written in another case has never been produced by any build.
fontrequired	FontSetting	Mono-restricted, and deliberately not Global's `code_font`: a code block in a document and a terminal grid are different surfaces, and somebody who wants a wide face for one rarely wants it for the other.
zoomrequired	Zoom	A zoom factor, valid only within the range the app has always accepted. Out of range is ignored rather than clamped - the guarded-geometry stance: a file carrying nonsense keeps the default rather than snapping to a surprising value the person never chose.
cursor_colorrequired	CaretColorChoice	`caret_color=`, and the terminal row's `cursor_color=`.
cursor_widthrequired	TerminalCursorWidth	The terminal row's `cursor_width=`. `application` means "follow the app's caret width" - the terminal's own spelling of a follow state, and unrelated to the four font settings.
cursor_heightrequired	TerminalCursorHeight	The terminal row's `cursor_height=`.
cursor_blinkrequired	TerminalCursorBlink	The terminal row's `cursor_blink=`.
composer_defaultrequired	boolean	Whether a new window opens with its composer showing. The default only. Whether the composer is open in a window that already exists is furniture, and stays that window's `input_area` row.

Example

{
  "theme": "system",
  "font": {},
  "zoom": 0,
  "cursor_color": "default",
  "cursor_width": "application",
  "cursor_height": "application",
  "cursor_blink": "application",
  "composer_default": false
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

Generated from contract version 1. Last updated November 12, 2026.