Struct TerminalConfig 

pub struct TerminalConfig {
    pub cols: usize,
    pub rows: usize,
    pub font_family: String,
    pub font_size: Pixels,
    pub scrollback: usize,
    pub line_height_multiplier: f32,
    pub padding: Edges<Pixels>,
    pub colors: ColorPalette,
}

Configuration for terminal creation and runtime updates.

This struct defines the terminal’s appearance and behavior, including grid dimensions, font settings, scrollback buffer, and color scheme.

Default Values

Field	Default
cols	80
rows	24
font_family	“monospace”
font_size	14px
scrollback	10000
line_height_multiplier	1.2
padding	0px all sides
colors	Default palette

Example

use gpui::{Edges, px};
use gpui_terminal::{ColorPalette, TerminalConfig};

let config = TerminalConfig {
    cols: 120,
    rows: 40,
    font_family: "JetBrains Mono".into(),
    font_size: px(13.0),
    scrollback: 50000,
    line_height_multiplier: 1.1,
    padding: Edges::all(px(10.0)),
    colors: ColorPalette::builder()
        .background(0x1a, 0x1a, 0x1a)
        .foreground(0xe0, 0xe0, 0xe0)
        .build(),
};

Runtime Updates

Configuration can be updated at runtime via TerminalView::update_config. This is useful for implementing features like dynamic font sizing:

terminal.update(cx, |terminal, cx| {
    let mut config = terminal.config().clone();
    config.font_size += px(1.0);
    terminal.update_config(config, cx);
});

Fields

cols: usize

Number of columns (character width) in the terminal

rows: usize

Number of rows (lines) in the terminal

font_family: String

Font family name (e.g., “Fira Code”, “JetBrains Mono”)

font_size: Pixels

Font size in pixels

scrollback: usize

Maximum number of scrollback lines to keep in history

line_height_multiplier: f32

Multiplier for line height to accommodate tall glyphs (e.g., nerd fonts) Default is 1.2 (20% extra height)

padding: Edges<Pixels>

Padding around the terminal content (top, right, bottom, left) The padding area renders with the terminal’s background color

colors: ColorPalette

Color palette for terminal colors (16 ANSI colors, 256 extended colors, foreground, background, and cursor colors)

Trait Implementations

impl Clone for TerminalConfig

fn clone(&self) -> TerminalConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TerminalConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TerminalConfig

fn default() -> Self

Returns the “default value” for a type.