tui schema (751-900)

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

TUI configuration — terminal dashboard settings.

Previous Next

Field path	Type	Required	Default	Canonical description
└ `tui.graphics.bubble.background_width`	`string`	optional		Explicit background image width: <n>px or <n>cols. Preserves aspect ratio.
└ `tui.graphics.bubble.background_height`	`string`	optional		Explicit background image height: <n>px, <n>rows, or <n>cols. Preserves aspect ratio.
└ `tui.graphics.bubble.background_scale_factor`	`f64`	optional	1.0	Additional scale factor applied after scale mode.
└ `tui.graphics.bubble.background_offset_x`	`f64`	optional	0.0	Horizontal offset as percentage of container width.
└ `tui.graphics.bubble.background_offset_y`	`f64`	optional	0.0	Vertical offset as percentage of container height.
└ `tui.graphics.bubble.background_offset_x_image`	`f64`	optional	0.0	Horizontal offset as percentage of rendered image width.
└ `tui.graphics.bubble.background_offset_y_image`	`f64`	optional	0.0	Vertical offset as percentage of rendered image height.
└ `tui.graphics.bubble.background_rotation`	`string`	optional	cycle	Rotation mode for multi-image backgrounds: cycle or random.
└ `tui.graphics.bubble.blend_mode`	`string`	optional	split	Border join blend mode: split or overlap.
└ `tui.graphics.bubble.blending_mode`	`string`	optional	normal	Composition blending mode for multi-layer surfaces: normal, multiply, screen, overlay, add.
└ `tui.graphics.bubble.merge_into_previous_layer`	`bool`	optional	true	Composite this layer into the same raster as preceding layers.
└ `tui.graphics.bubble.draw_above_cell_backgrounds`	`bool`	optional	false	Render this layer above kitty cell backgrounds.
└ `tui.graphics.bubble.color`	`string`	optional	auto	Base color override: auto, hex (#rrggbb), or theme color (colorN).
└ `tui.graphics.bubble.focused_color`	`string`	optional		Focused-state color override.
└ `tui.graphics.bubble.selected_color`	`string`	optional		Selected-state color override.
└ `tui.graphics.bubble.active_color`	`string`	optional		Active-state color override.
└ `tui.graphics.bubble.material`	`map`	optional		Single-pass inset material; preserves semantic tint and alpha. Not desktop backdrop blur.
└ `tui.graphics.bubble.material.kind`	`string`	optional	none	Finish: none, glass, satin, chrome, paper.
└ `tui.graphics.bubble.material.depth`	`u8`	optional	18	Inset shadow strength, saturating percent.
└ `tui.graphics.bubble.material.sheen`	`u8`	optional	12	Directional reflection strength, saturating percent.
└ `tui.graphics.bubble.material.grain`	`u8`	optional	2	Stable microtexture strength, saturating percent.
└ `tui.graphics.bubble.material.width`	`u16`	optional	18	Inset falloff width in logical raster pixels.
└ `tui.graphics.bubble.material.motion`	`u8`	optional	0	Reflection/depth motion percent; requires background_animate and enabled animations. Zero stays static.
└ `tui.graphics.bubble.inner_glow`	`map`	optional		Inner glow effect config for inner_glow background style.
└ `tui.graphics.bubble.inner_glow.radius`	`u32`	optional	8	Glow spread radius in pixels.
└ `tui.graphics.bubble.inner_glow.intensity`	`f64`	optional	0.5	Peak glow intensity 0.0–1.0.
└ `tui.graphics.bubble.inner_glow.opacity`	`f64`	optional	0.6	Glow opacity 0.0–1.0.
└ `tui.graphics.bubble.radial_glow`	`map`	optional		Radial glow effect config for radial_glow background style.
└ `tui.graphics.bubble.radial_glow.anchor`	`string`	optional	center	Glow center anchor: center, top, top_right, right, bottom_right, bottom, bottom_left, left, top_left.
└ `tui.graphics.bubble.radial_glow.radius`	`string`	optional	half_longest	Radius spec: half_width, half_height, half_longest, half_shortest, or absolute(N).
└ `tui.graphics.bubble.radial_glow.intensity`	`f64`	optional	0.5	Peak glow intensity 0.0–1.0.
└ `tui.graphics.bubble.radial_glow.opacity`	`f64`	optional	0.6	Glow opacity 0.0–1.0.
└ `tui.graphics.bubble.scanline`	`map`	optional		CRT scanline effect config for scanlines background style.
└ `tui.graphics.bubble.scanline.spacing`	`u32`	optional	3	Vertical spacing between scanlines in pixels.
└ `tui.graphics.bubble.scanline.intensity`	`f64`	optional	0.5	Scanline darkness intensity 0.0–1.0.
└ `tui.graphics.bubble.scanline.warp`	`f64`	optional	0.3	Sinusoidal warp curvature amount 0.0–1.0.
└ `tui.graphics.bubble.padding`	`map`	optional		Inner padding in cells inside the border.
└ `tui.graphics.bubble.padding.top`	`u16`	optional	0	Cells of padding above content.
└ `tui.graphics.bubble.padding.bottom`	`u16`	optional	0	Cells of padding below content.
└ `tui.graphics.bubble.padding.left`	`u16`	optional	0	Cells of padding left of content.
└ `tui.graphics.bubble.padding.right`	`u16`	optional	0	Cells of padding right of content.
└ `tui.graphics.bubble.disable_on_scroll`	`bool`	optional		Temporarily fall back to ASCII on scroll.
└ `tui.graphics.bubble.min_height`	`u16`	optional	1	Minimum button height in cells. 1 = compact pill mode, 3+ = bordered mode.
└ `tui.graphics.bubble.button_decoration_style`	`string`	optional	pill	Compact button decoration style: none, glow, box, pill, glass_pill. Used for 1-2 row buttons.
└ `tui.graphics.bubble.animation_phase_offset`	`f32`	optional	0.0	Additive phase offset for animation cycle 0.0–1.0.
└ `tui.graphics.bubble.overrides`	`map[string, map]`	optional		Per-instance style overrides keyed by instance name. Each value accepts the same fields as the parent style.
└ `tui.graphics.bubble.active_overrides`	`map`	optional		Active/selected-state style overrides.
└ `tui.graphics.bubble.inactive_overrides`	`map`	optional		Inactive-state style overrides for tab roles.
└ `tui.graphics.bubble.focused_overrides`	`map`	optional		Focused-state style overrides.
└ `tui.graphics.line`	`map`	optional		Standalone line graphics style for timeline connectors and dividers.
└ `tui.graphics.line.tint`	`string`	optional		Background tint color: hex (#rrggbb), match_border, or colorN.
└ `tui.graphics.line.tint_intensity`	`f64`	optional	0.15	Background tint blend intensity 0.0–1.0.
└ `tui.graphics.line.background_style`	`string`	optional	none	Background fill style: none, solid, or gradient.
└ `tui.graphics.line.background_opacity`	`f64`	optional	1.0	Background alpha multiplier for bitmap panel fills.
└ `tui.graphics.line.background_contrast`	`f64`	optional	1.08	Alternate background gradient brightness multiplier.
└ `tui.graphics.line.background_angle`	`f64`	optional	35.0	Gradient direction in degrees for bitmap panel fills.
└ `tui.graphics.line.background_animate`	`bool`	optional	false	Scroll the background gradient when animations are enabled.
└ `tui.graphics.line.background_animation_speed`	`f64`	optional	0.25	Background animation speed in cycles per second.
└ `tui.graphics.line.animation_speed`	`f64`	optional	0.25	Border animation speed in cycles per second, using the same units as background_animation_speed.
└ `tui.graphics.line.animation_frames`	`u16`	optional	96	Number of temporal phase buckets per animation cycle; speed controls cycle duration. Values above 255 require 16-bit-capable clients.
└ `tui.graphics.line.animation_style`	`string`	optional	pulse	Border animation style: pulse or rotating_gradient.
└ `tui.graphics.line.border_animation_style`	`string`	optional		Border-specific animation style override: pulse or rotating_gradient. Overrides animation_style for border perimeters only.
└ `tui.graphics.line.border_spacing`	`u32`	optional	100	Bias for how far strokes sit toward the outer edge of a border cell.
└ `tui.graphics.line.line_thickness`	`f64`	optional	1.0	Stroke thickness multiplier for bitmap borders.
└ `tui.graphics.line.pattern`	`string`	optional	solid	Stroke pattern: solid, diagonal_stripes, checkerboard, dashed, dotted, houndstooth, bevel, etched.
└ `tui.graphics.line.pattern_size`	`u32`	optional	3	Stroke pattern tile size in pixels at 1x scale.
└ `tui.graphics.line.pattern_opacity`	`f64`	optional	0.72	Alternate pattern alpha multiplier.
└ `tui.graphics.line.pattern_contrast`	`f64`	optional	0.86	Alternate pattern brightness multiplier.
└ `tui.graphics.line.glow`	`bool`	optional	false	Enable glow effect on bitmap borders.
└ `tui.graphics.line.glow_radius`	`u32`	optional	4	Glow spread radius in pixels at 1x scale.
└ `tui.graphics.line.glow_intensity`	`f64`	optional	0.35	Glow intensity multiplier.
└ `tui.graphics.line.pulse_low`	`f64`	optional	0.0	Minimum normalized oscillation point for animated border effects.
└ `tui.graphics.line.pulse_high`	`f64`	optional	1.0	Maximum normalized oscillation point for animated border effects.
└ `tui.graphics.line.shadow_intensity`	`f64`	optional	0.0	Drop-shadow intensity behind the bitmap stroke.
└ `tui.graphics.line.stroke_intensity`	`f64`	optional	0.0	Outline/stroke intensity around the bitmap stroke.
└ `tui.graphics.line.corner_radius`	`u32`	optional	4	Rounded corner radius in pixels at 1x scale.
└ `tui.graphics.line.title_gap_terminator`	`string`	optional	tick	Terminator style used when carving title gaps from top border runs: none, tick, tack, box, pill.
└ `tui.graphics.line.header_decoration_style`	`string`	optional	none	Text decoration style for header/title kitty surfaces: none, glow, box, pill, glass_pill.
└ `tui.graphics.line.header_decoration_thickness`	`f64`	optional	0.5	Thickness multiplier for header decoration strokes, relative to border thickness.
└ `tui.graphics.line.header_decoration_radius`	`u32`	optional	3	Corner radius for header decoration box/pill containers.
└ `tui.graphics.line.header_decoration_glow_radius`	`u32`	optional	2	Glow spread radius for header text glow decoration.
└ `tui.graphics.line.header_decoration_opacity`	`f64`	optional	0.6	Opacity multiplier for header decoration surfaces.
└ `tui.graphics.line.span_glow_enabled`	`bool`	optional	true	Enable span-level glow effects on header/footer text elements.
└ `tui.graphics.line.span_glow_radius`	`u32`	optional	2	Glow spread radius for span-level glow effects in cells.
└ `tui.graphics.line.span_glow_intensity`	`f64`	optional	0.35	Opacity/intensity multiplier for span-level glow effects.
└ `tui.graphics.line.span_glow_bleed_x`	`u16`	optional	2	Extra columns the glow image extends beyond text cells on each side.
└ `tui.graphics.line.span_glow_bleed_y`	`u16`	optional	1	Extra rows the glow image extends beyond text cells on each side.
└ `tui.graphics.line.foreground_color`	`string`	optional		Foreground color override for text/chrome in this role (hex or colorN).
└ `tui.graphics.line.background_color`	`string`	optional		Background color override for panel fills in this role (hex or colorN).
└ `tui.graphics.line.background_overlay`	`string`	optional	none	Composable overlay effect on top of background: none or scanlines.
└ `tui.graphics.line.background_overlay_opacity`	`f64`	optional	0.15	Overlay opacity/intensity 0.0–1.0.
└ `tui.graphics.line.background_image`	`string \| list[string]`	optional		Background image path or list of paths for rotation.
└ `tui.graphics.line.background_position`	`string`	optional	center	Background image position anchor: center, top, bottom, left, right, etc..
└ `tui.graphics.line.background_scale`	`string`	optional	fit_width	Background image scale mode: fit_width, fit_height, fit_longest, fit_shortest.
└ `tui.graphics.line.background_width`	`string`	optional		Explicit background image width: <n>px or <n>cols. Preserves aspect ratio.
└ `tui.graphics.line.background_height`	`string`	optional		Explicit background image height: <n>px, <n>rows, or <n>cols. Preserves aspect ratio.
└ `tui.graphics.line.background_scale_factor`	`f64`	optional	1.0	Additional scale factor applied after scale mode.
└ `tui.graphics.line.background_offset_x`	`f64`	optional	0.0	Horizontal offset as percentage of container width.
└ `tui.graphics.line.background_offset_y`	`f64`	optional	0.0	Vertical offset as percentage of container height.
└ `tui.graphics.line.background_offset_x_image`	`f64`	optional	0.0	Horizontal offset as percentage of rendered image width.
└ `tui.graphics.line.background_offset_y_image`	`f64`	optional	0.0	Vertical offset as percentage of rendered image height.
└ `tui.graphics.line.background_rotation`	`string`	optional	cycle	Rotation mode for multi-image backgrounds: cycle or random.
└ `tui.graphics.line.blend_mode`	`string`	optional	split	Border join blend mode: split or overlap.
└ `tui.graphics.line.blending_mode`	`string`	optional	normal	Composition blending mode for multi-layer surfaces: normal, multiply, screen, overlay, add.
└ `tui.graphics.line.merge_into_previous_layer`	`bool`	optional	true	Composite this layer into the same raster as preceding layers.
└ `tui.graphics.line.draw_above_cell_backgrounds`	`bool`	optional	false	Render this layer above kitty cell backgrounds.
└ `tui.graphics.line.color`	`string`	optional	auto	Base color override: auto, hex (#rrggbb), or theme color (colorN).
└ `tui.graphics.line.focused_color`	`string`	optional		Focused-state color override.
└ `tui.graphics.line.selected_color`	`string`	optional		Selected-state color override.
└ `tui.graphics.line.active_color`	`string`	optional		Active-state color override.
└ `tui.graphics.line.material`	`map`	optional		Single-pass inset material; preserves semantic tint and alpha. Not desktop backdrop blur.
└ `tui.graphics.line.material.kind`	`string`	optional	none	Finish: none, glass, satin, chrome, paper.
└ `tui.graphics.line.material.depth`	`u8`	optional	18	Inset shadow strength, saturating percent.
└ `tui.graphics.line.material.sheen`	`u8`	optional	12	Directional reflection strength, saturating percent.
└ `tui.graphics.line.material.grain`	`u8`	optional	2	Stable microtexture strength, saturating percent.
└ `tui.graphics.line.material.width`	`u16`	optional	18	Inset falloff width in logical raster pixels.
└ `tui.graphics.line.material.motion`	`u8`	optional	0	Reflection/depth motion percent; requires background_animate and enabled animations. Zero stays static.
└ `tui.graphics.line.inner_glow`	`map`	optional		Inner glow effect config for inner_glow background style.
└ `tui.graphics.line.inner_glow.radius`	`u32`	optional	8	Glow spread radius in pixels.
└ `tui.graphics.line.inner_glow.intensity`	`f64`	optional	0.5	Peak glow intensity 0.0–1.0.
└ `tui.graphics.line.inner_glow.opacity`	`f64`	optional	0.6	Glow opacity 0.0–1.0.
└ `tui.graphics.line.radial_glow`	`map`	optional		Radial glow effect config for radial_glow background style.
└ `tui.graphics.line.radial_glow.anchor`	`string`	optional	center	Glow center anchor: center, top, top_right, right, bottom_right, bottom, bottom_left, left, top_left.
└ `tui.graphics.line.radial_glow.radius`	`string`	optional	half_longest	Radius spec: half_width, half_height, half_longest, half_shortest, or absolute(N).
└ `tui.graphics.line.radial_glow.intensity`	`f64`	optional	0.5	Peak glow intensity 0.0–1.0.
└ `tui.graphics.line.radial_glow.opacity`	`f64`	optional	0.6	Glow opacity 0.0–1.0.
└ `tui.graphics.line.scanline`	`map`	optional		CRT scanline effect config for scanlines background style.
└ `tui.graphics.line.scanline.spacing`	`u32`	optional	3	Vertical spacing between scanlines in pixels.
└ `tui.graphics.line.scanline.intensity`	`f64`	optional	0.5	Scanline darkness intensity 0.0–1.0.
└ `tui.graphics.line.scanline.warp`	`f64`	optional	0.3	Sinusoidal warp curvature amount 0.0–1.0.
└ `tui.graphics.line.padding`	`map`	optional		Inner padding in cells inside the border.
└ `tui.graphics.line.padding.top`	`u16`	optional	0	Cells of padding above content.
└ `tui.graphics.line.padding.bottom`	`u16`	optional	0	Cells of padding below content.
└ `tui.graphics.line.padding.left`	`u16`	optional	0	Cells of padding left of content.
└ `tui.graphics.line.padding.right`	`u16`	optional	0	Cells of padding right of content.
└ `tui.graphics.line.disable_on_scroll`	`bool`	optional		Temporarily fall back to ASCII on scroll.
└ `tui.graphics.line.min_height`	`u16`	optional	1	Minimum button height in cells. 1 = compact pill mode, 3+ = bordered mode.
└ `tui.graphics.line.button_decoration_style`	`string`	optional	pill	Compact button decoration style: none, glow, box, pill, glass_pill. Used for 1-2 row buttons.
└ `tui.graphics.line.animation_phase_offset`	`f32`	optional	0.0	Additive phase offset for animation cycle 0.0–1.0.
└ `tui.graphics.line.overrides`	`map[string, map]`	optional		Per-instance style overrides keyed by instance name. Each value accepts the same fields as the parent style.
└ `tui.graphics.line.active_overrides`	`map`	optional		Active/selected-state style overrides.
└ `tui.graphics.line.inactive_overrides`	`map`	optional		Inactive-state style overrides for tab roles.
└ `tui.graphics.line.focused_overrides`	`map`	optional		Focused-state style overrides.
└ `tui.graphics.bottomPanel`	`map`	optional		Bottom panel bitmap border style overrides. Falls back to panel style when absent.
└ `tui.graphics.bottomPanel.tint`	`string`	optional		Background tint color: hex (#rrggbb), match_border, or colorN.
└ `tui.graphics.bottomPanel.tint_intensity`	`f64`	optional	0.15	Background tint blend intensity 0.0–1.0.
└ `tui.graphics.bottomPanel.background_style`	`string`	optional	none	Background fill style: none, solid, or gradient.
└ `tui.graphics.bottomPanel.background_opacity`	`f64`	optional	1.0	Background alpha multiplier for bitmap panel fills.
└ `tui.graphics.bottomPanel.background_contrast`	`f64`	optional	1.08	Alternate background gradient brightness multiplier.
└ `tui.graphics.bottomPanel.background_angle`	`f64`	optional	35.0	Gradient direction in degrees for bitmap panel fills.

Previous Next