Colors
Color scheme configure colors that are used inside terminal. To specify which color scheme you want to use you need to define the name of the scheme inside profile configuration or inline colors inside profile.
Color scheme configuration
Color configuration is set under profiles with colors.
Then the scheme is defined under color_schemes.
default
section defines the default colors used in the terminal.
color_schemes:
default:
default:
background: '#1a1716'
foreground: '#d0d0d0'
bright_foreground: '#ffffff'
dimmed_foreground: '#808080'
foreground option sets the default foreground text color of the terminal.
bright_foreground option sets the default foreground text color of the terminal when text text is instructed to be bold (/bright). This is only used if profile option
draw_bold_text_with_bright_colors is set to truedimmed_foreground option sets the default foreground text color of the terminal when text text is instructed to be dimmed.
background_image
section in the configuration file allows you to control various aspects of the background image feature.
path To specify the image file to use as the background, you need to provide the full path to the image. Both~ (home directory) and ${VAR} (environment variable) expansion are supported — see Path Handling for details. By default, the path option is set to an empty string, indicating that background image support is disabled. opacity option controls the opacity of the background image. It determines how transparent or intense the image appears. The default value is 0.5, which provides a moderately transparent background. You can adjust this value to make the image more or less prominent, depending on your preferences.
blur option applies a blur effect to the background image. This can help reduce distractions and keep the focus on the terminal contents. By default, the blur option is set to false, indicating that background image blurring is disabled. If you want to enable it, set the value to true.
cursor
section in the configuration file let you customize the color of the cursor and optionally override the text color.
default option allows you to specify the color of the cursor shape. By default, the default value is set to CellForeground, which means the cursor color will be the same as the cell's foreground color. You can change this value to any valid RGB color or use the special options CellForeground or CellBackground.text allows you to specify the color of the characters that would be covered by the cursor shape. This is useful for ensuring readability when the cursor overlaps with the text. By default, the text value is set to CellBackground, which means the overridden text color will be the same as the cell's background color. Similarly to the default option, you can specify any valid RGB color or use the CellForeground or CellBackground options.
hyperlink_decoration
allows you to customize the colors used for hyperlink decoration when hovering over them. These colours apply to the links Contour detects in output as well as to OSC 8 hyperlinks.
normal defines the color to be used for hyperlink decoration in its normal state (not being hovered).hover determines the color to be applied to hyperlink decoration when it is being hovered over.
vi_mode_highlight
customize the colors used for highlighting in Vi mode.
color_schemes:
default:
vi_mode_highlight:
foreground: CellForeground
foreground_alpha: 1.0
background: '#ffa500'
background_alpha: 0.5
foreground_alpha option determines the transparency level of the foreground color. It accepts a value between 0.0 (fully transparent) and 1.0 (fully opaque). This option allows you to control the visibility of the highlighted text.
background option in the vi_mode_highlight section defines the color to be used for the background of the highlighted text.
background_alpha option controls the transparency level of the background color. It accepts a value between 0.0 (fully transparent) and 1.0 (fully opaque).
vi_mode_cursorline
customize the colors used for the cursor line in Vi mode. Options similar to vi_mode_highlight.
color_schemes:
default:
vi_mode_cursorline:
foreground: CellForeground
foreground_alpha: 1.0
background: '#ffa500'
background_alpha: 0.5
selection
section customize the colors used for text selection. Options similar to vi_mode_highlight.
color_schemes:
default:
selection:
foreground: CellForeground
foreground_alpha: 1.0
background: '#4040f0'
background_alpha: 0.5
search_highlight
section customize the colors used for search highlight. Options similar to vi_mode_highlight.
color_schemes:
default:
search_highlight:
foreground: CellForeground
foreground_alpha: 1.0
background: '#4040f0'
background_alpha: 0.5
search_highlight_focused
section customize the colors used for focused search highlight. Options similar to vi_mode_highlight.
color_schemes:
default:
search_highlight_focused:
foreground: CellForeground
foreground_alpha: 1.0
background: '#4040f0'
background_alpha: 0.5
word_highlight_current
Coloring for the word that is highlighted due to double-clicking it. Options similar to vi_mode_highlight.
color_schemes:
default:
word_highlight_current:
foreground: CellForeground
foreground_alpha: 1.0
background: '#4040f0'
background_alpha: 0.5
word_highlight_other
Coloring for the word that is highlighted due to double-clicking another word that matches this word. Options similar to vi_mode_highlight.
color_schemes:
default:
word_highlight_other:
foreground: CellForeground
foreground_alpha: 1.0
background: '#4040f0'
background_alpha: 0.5
indicator_statusline
Defines the colors to be used for the Indicator status line. Configuration entry consist of following sections, namely default, inactive, insert_mode, normal_mode, visual_mode. Each section have foreground and background options. You can specify only the sections you want to customize after configuring the default section.
Minimal configuration looks like this:
fold_marker
Defines the colors of the fold markers drawn in the gutter's block column, left of the grid, when output
folding is enabled (see folding.show_markers). Two independent sections, default and hover,
each with foreground and background; hover applies to the whole run of the fold the pointer is
currently over, not just the row under it.
Both are optional, and left unset by default. When a section is missing, its colors are derived
from this scheme's own default foreground and background: at rest the glyph is faded partway
toward the background so it stays quieter than the text beside it, and on hover it comes up to the
full foreground. Only the glyph changes — the background stays the page's own in both states, so the
gutter never paints over a transparent window. That is what lets a scheme which has never heard of
folding still draw a legible, obviously-clickable column, in light and dark themes alike — so only
set these if you actively want something else.
color_schemes:
default:
fold_marker:
default:
foreground: '#7e7c7c'
background: '#1a1716'
hover:
foreground: '#d0d0d0'
background: '#1a1716'
default Colors of the fold column at rest. Set the background to
this scheme's own background to keep the gutter transparent along with the rest of the window.
hover Colors of the fold run under the pointer — the whole run of
the hovered fold, not just the row beneath it.
block_status
Defines the colors of a command block's marks by how its command ended (see
Command blocks): what the gutter's block column draws beside it while
gutter.exit_status is on (the default), and its tick on the scrollbar. Each is a single color, and all
three are optional, left unset by default. A missing one is derived from this scheme, so a scheme that
has never heard of them still shows them legibly:
success— a command that exited with 0, or whose exit status is unknown. Derived from the fold marker's color, so a successful block looks exactly as the fold column always has.failure— a command that exited non-zero, or was killed. Derived from this scheme's normal red (normal color 1).running— a command that has not finished yet. Derived from this scheme's normal yellow (normal color 3).
Under the pointer, failure and running — and a success set here — are lifted halfway toward the text
color; an unset success comes up to full strength, as the fold column does.
The values shown are what the default scheme derives.
gutter_text
The color of the gutter's line numbers and timestamps, and of the chip a collapsed fold carries
(1,234 lines hidden ⌄), lifted where it would not read on the chip's band. Optional, and unset by default: it is then this scheme's foreground faded toward its
background, as the resting fold markers are, so the numbers stay quieter than the text beside them.
sticky_header
Defines the colors of the sticky command header (see the profile key sticky_header): the band pinned
over the top row while you read a command's output with the command itself scrolled out of view, and
the one-pixel line along its bottom edge.
Both are optional, and unset by default. A missing one is derived from this scheme's own default
colors: the band is the background lifted a tenth of the way toward the foreground, the line about a
third of the way — quiet in every theme, yet distinct from the page.
background The band's color. The command copied into it keeps its own
colors; only the cells the shell left on the default background take this one.
separator The one-pixel line along the band's bottom edge.
Palette Presets
When choosing a palette from a preset as the color scheme (in profiles) it is possible to tweak any configuration:
color_schemes:
one-light:
word_highlight_other:
foreground: CellForeground
background: CellBackground
foreground_alpha: 1.0
background_alpha: 1.0
Complete configuration looks like this:
color_schemes:
default:
indicator_statusline:
default:
foreground: '#FFFFFF'
background: '#0270C0'
inactive:
foreground: '#FFFFFF'
background: '#0270C0'
insert_mode:
foreground: '#FFFFFF'
background: '#0270C0'
normal_mode:
foreground: '#0F0002'
background: '#0270C0'
visual_mode:
foreground: '#FFFFFF'
background: '#0270C0'
normal
Normal colors
color_schemes:
default:
normal:
black: '#000000'
red: '#c63939'
green: '#00a000'
yellow: '#a0a000'
blue: '#4d79ff'
magenta: '#ff66ff'
cyan: '#00a0a0'
white: '#c0c0c0'
bright
Bright colors
color_schemes:
default:
bright:
black: '#707070'
red: '#ff0000'
green: '#00ff00'
yellow: '#ffff00'
blue: '#0000ff'
magenta: '#ff00ff'
cyan: '#00ffff'
white: '#ffffff'
Writing a palette
normal, bright and dim each take their eight colors either by name, as above, or as a list in the
order black, red, green, yellow, blue, magenta, cyan, white:
color_schemes:
default:
bright: ['#707070', '#ff0000', '#00ff00', '#ffff00', '#0000ff', '#ff00ff', '#00ffff', '#ffffff']
'#rrggbb' (quoted, since # would otherwise start a YAML comment) or as 0xrrggbb. A bare decimal number
is not a color, and leaves its slot as it was.
Default color scheme
color_schemes:
default:
default:
background: '#1a1716'
foreground: '#d0d0d0'
background_image:
opacity: 0.5
blur: false
cursor:
default: CellForeground
text: CellBackground
hyperlink_decoration:
normal: '#f0f000'
hover: '#ff0000'
vi_mode_highlight:
foreground: CellForeground
foreground_alpha: 1.0
background: '#ffa500'
background_alpha: 0.5
vi_mode_cursorline:
foreground: '#ffffff'
foreground_alpha: 0.2
background: '#808080'
background_alpha: 0.4
selection:
foreground: CellForeground
foreground_alpha: 1.0
background: '#4040f0'
background_alpha: 0.5
search_highlight:
foreground: CellBackground
background: CellForeground
foreground_alpha: 1.0
background_alpha: 1.0
search_highlight_focused:
foreground: CellBackground
background: CellForeground
foreground_alpha: 1.0
background_alpha: 1.0
word_highlight_current:
foreground: CellForeground
background: '#909090'
foreground_alpha: 1.0
background_alpha: 0.5
word_highlight_other:
foreground: CellForeground
background: '#909090'
foreground_alpha: 1.0
background_alpha: 0.5
indicator_statusline:
default:
foreground: '#FFFFFF'
background: '#0270C0'
inactive:
foreground: '#FFFFFF'
background: '#0270C0'
insert_mode:
foreground: '#FFFFFF'
background: '#0270C0'
normal_mode:
foreground: '#FFFFFF'
background: '#0270C0'
visual_mode:
foreground: '#FFFFFF'
background: '#0270C0'
# fold_marker:
# default:
# foreground: '#7e7c7c'
# background: '#1a1716'
# hover:
# foreground: '#d0d0d0'
# background: '#1a1716'
# block_status:
# success: '#7E7C7C'
# failure: '#C63939'
# running: '#A0A000'
# gutter_text: '#7E7C7C'
# sticky_header:
# background: '#2C2928'
# separator: '#595757'
input_method_editor:
foreground: '#FFFFFF'
background: '#FF0000'
normal:
black: '#000000'
red: '#c63939'
green: '#00a000'
yellow: '#a0a000'
blue: '#4d79ff'
magenta: '#ff66ff'
cyan: '#00a0a0'
white: '#c0c0c0'
bright:
black: '#707070'
red: '#ff0000'
green: '#00ff00'
yellow: '#ffff00'
blue: '#0000ff'
magenta: '#ff00ff'
cyan: '#00ffff'
white: '#ffffff'