Configuration

Frostty by default does not place any configuration files on your system. It expects your config to be placed at

$HOME/.config/frostty/frostty.toml

Frostty will read and apply any settings you configure and for any unconfigured settings the defaults will be used. Below is a list of all configurable variables and their default values.

General

This section documents the [general] table of the configuration.

wallpaper = "<string>"

Set the wallpaper for the terminal.

Expects the string to be a path relative to the location of your frostty.toml.

scroll = <integer>

Scroll sensitivity for terminal. Provide a negative number to invert scroll.

Default: 3

gaps = <float>

Gap size between terminal panes in pixels.

Default: 0.0

Window

This section documents the [window] table of the configuration.

dimensions = { width = <float>, height = <float> }

Set the starting window dimensions for Frostty.

Default: { width = 790.0, height = 460.0 }

level = "Normal" | "AlwaysOnTop"

Set the window level.

Default: "Normal"

mode = "Windowed" | "Maximized" | "Fullscreen"

Set window startup mode.

Default: "Windowed"

Font

This section documents the [font] table of the configuration.

family = "<string>"

Set the terminal font family.

Default: "Monospace"

size = <float>

Set the terminal font size.

Default: 14.0

Colors

This section documents the [colors] table of the configuration.

Colors are in hexadecimal format with a # prefix: #RRGGBBAA

The alpha channel is not available for the [colors.app] table, and is optional for all other colors. If alpha is not specified it is assumed to be full opacity.

app

This section documents the [colors.app] table of the configuration.

background = "<string>"

Default: "#181818"

active = "<string>"

Default: "#ac4242"

inactive = "<string>"

Default: "#d8d8d8"

primary

This section documents the [colors.primary] table of the configuration.

foreground = "<string>"

Default: "#d8d8d8"

background = "<string>"

Default: "#181818"

dim_foreground = "<string>"

Default: "#828482"

bright_foreground = "<string>"

Is optional and just clones the foreground color by default.

Default: "None"

normal

This section documents the [colors.normal] table of the configuration.

black = "<string>"

Default: "#181818"

red = "<string>"

Default: "#ac4242"

green = "<string>"

Default: "#90a959"

yellow = "<string>"

Default: "#f4bf75"

blue = "<string>"

Default: "#6a9fb5"

magenta = "<string>"

Default: "#aa759f"

cyan = "<string>"

Default: "#75b5aa"

white = "<string>"

Default: "#d8d8d8"

bright

This section documents the [colors.bright] table of the configuration.

black = "<string>"

Default: "#6b6b6b"

red = "<string>"

Default: "#c55555"

green = "<string>"

Default: "#aac474"

yellow = "<string>"

Default: "#feca88"

blue = "<string>"

Default: "#82b8c8"

magenta = "<string>"

Default: "#c28cb8"

cyan = "<string>"

Default: "#93d3c3"

white = "<string>"

Default: "#f8f8f8"

dim

This section documents the [colors.dim] table of the configuration.

black = "<string>"

Default: "#0f0f0f"

red = "<string>"

Default: "#712b2b"

green = "<string>"

Default: "#5f6f3a"

yellow = "<string>"

Default: "#a17e4d"

blue = "<string>"

Default: "#456877"

magenta = "<string>"

Default: "#704d68"

cyan = "<string>"

Default: "#4d7770"

white = "<string>"

Default: "#8e8e8e"

Bell

This section documents the [bell] table of the configuration.

duration = <integer>

Set the duration of the bell flash in milliseconds. A duration of 0 will disable the bell.

Default: 0

color = "<string>"

Visual bell flash color. If not defined there will be no flash.

Default: None

command = "<string>" | { program = "<string>", args = ["<string>",] }

The command to be executed whenever the bell is triggered. By default there is no command. This can work even if the visual flash is disabled but does require a non-zero duration.

Default: None