2024-07-12 10:20:53 +01:00
# Default Contour Configuration File.
# Overrides the auto-detected platform plugin to be loaded.
#
# Possible (incomplete list of) values are:
# - auto The platform will be auto-detected.
# - xcb Uses XCB plugin (for X11 environment).
# - cocoa Used to be run on Mac OS/X.
# - direct2d Windows platform plugin using Direct2D.
# - winrt Windows platform plugin using WinRT.
#
# Default: auto
platform_plugin : auto
# VT Renderer configuration.
# ADVANCED! Do not touch unless you know what you are doing.
renderer :
# Backend to use for rendering the terminal onto the screen
#
# Possible values are:
# - default Uses the default rendering option as decided by the terminal.
# - software Uses software-based rendering.
# - OpenGL Use (possibly) hardware accelerated OpenGL
backend : OpenGL
# Number of hashtable slots to map to the texture tiles.
# Larger values may increase performance, but too large may also decrease.
# This value is rounded up to a value equal to the power of two.
#
# Default: 4096
tile_hashtable_slots : 4096
# Number of tiles that must fit at lest into the texture atlas.
#
# This does not include direct mapped tiles (US-ASCII glyphs,
# cursor shapes and decorations), if tile_direct_mapping is set to true).
#
# Value must be at least as large as grid cells available in the terminal view.
# This value is automatically adjusted if too small.
#
# Default: 4000
tile_cache_count : 4000
# Enables/disables the use of direct-mapped texture atlas tiles for
# the most often used ones (US-ASCII, cursor shapes, underline styles)
# You most likely do not want to touch this.
#
# Default: true
tile_direct_mapping : true
# Word delimiters when selecting word-wise.
word_delimiters : " /\\()\"'-.,:;<>~!@#$%^&*+=[]{}~?|│"
# Default PTY read buffer size.
#
# This is an advance option. Use with care!
# Default: 16384
read_buffer_size : 16384
# Size in bytes per PTY Buffer Object.
#
# This is an advanced option of an internal storage. Only change with care!
pty_buffer_size : 1048576
default_profile : my_profile
# Flag to determine whether to spawn new process or not when creating new terminal
# Default: false
spawn_new_process : false
# Whether or not to reflow the lines on terminal resize events.
# Default: true
reflow_on_resize : true
# Section of experimental features.
# All experimental features are disabled by default and must be explicitly enabled here.
# NOTE: Contour currently has no experimental features behind this configuration wall.
# experimental:
# # Enables experimental support for feature X/Y/Z
# feature_xyz: true
# This keyboard modifier can be used to bypass the terminal's mouse protocol,
# which can be used to select screen content even if the an application
# mouse protocol has been activated (Default: Shift).
#
# The same modifier values apply as with input modifiers (see below).
bypass_mouse_protocol_modifier : Shift
# Modifier to be pressed in order to initiate block-selection
# using the left mouse button.
#
# This is usually the Control modifier, but on OS/X that is not possible,
# so Alt or Meta would be recommended instead.
#
# Supported modifiers:
# - Alt
# - Control
# - Shift
# - Meta
#
# Default: Control
mouse_block_selection_modifier : Control
# Selects an action to perform when a text selection has been made.
#
# Possible values are:
#
# - None Does nothing
# - CopyToClipboard Copies the selection to the primary clipboard.
# - CopyToSelectionClipboard Copies the selection to the selection clipboard.
# This is not supported on all platforms.
#
# Default: CopyToSelectionClipboard
on_mouse_select : None
# Determines whether the instance is reloading the configuration files whenever it is changing or not.
#
# Default: false
live_config : true
# Inline image related default configuration and limits
# -----------------------------------------------------
images :
# Enable or disable sixel scrolling (SM/RM ?80 default)
sixel_scrolling : true
# Configures the maximum number of color registers available when rendering Sixel graphics.
sixel_register_count : 4096
# maximum width in pixels of an image to be accepted (0 defaults to system screen pixel width)
max_width : 0
# maximum height in pixels of an image to be accepted (0 defaults to system screen pixel height)
max_height : 0
# Terminal Profiles
# -----------------
#
# Dominates how your terminal visually looks like. You will need at least one terminal profile.
profiles :
main :
# You can override the process to be started inside the terminal.
# If nothing is specified, the users' default login shell will be used.
# But you may as well log in to a remote host.
# shell: "ssh ubuntu-vm"
# shell: "/bin/bash"
# arguments: ["some", "optional", "arguments", "for", "the", "shell"]
# Builtin SSH-client configuration.
# Use this to directly connect to an SSH server.
# This will bypass the local PTY creation
# ssh:
# # Target host name to connect to via SSH. This may be a DNS name or IPv4 or IPv6 address.
# # This value MUST be provided when attempting to directly establish a connection via SSH.
# #
# # Note, that based on this hostname, the ~/.ssh/config will be looked up and
# # be used as default values when connecting to this host.
# host: example.com
#
# # TCP/IP port to use to talk to the remote SSH server. This value defaults to 22.
# port: 22
#
# # Remote user name to use for logging into the the SSH server.
# # If not specified, the current local user name will be used as remote SSH login username.
# user: somebody
#
# # When attempting to authenticate with an SSH key, at least the private key must be provided.
# # This usually is something similar to "~/.ssh/id_rsa", but can vary.
# private_key: ""
#
# # The public key (e.g. "~/.ssh/your_key.pub") is usually not required, but some backends (not OpenSSL) may require it.
# # Defaults to an empty string (not specified).
# public_key: ""
#
# # This mandates where to look up for known hosts to guard against MITM attacks.
# # This file is compatible to OpenSSH and thus defaults
# # to the location of OpenSSH's known_hosts, "~/.ssh/known_hosts".
# known_hosts: "~/.ssh/known_hosts"
#
# # Mandates whether or not to enable SSH agent forwarding.
# # Default value currently is `false` (agent forwarding disabled),
# # and is for security reasons also the recommended way.
# forward_agent: false
# If this terminal is being executed from within Flatpak, enforces sandboxing
# then this boolean indicates whether or not that sandbox should be escaped or not.
#
# Default value is true.
#
# It only makes sense to set this value to false if you really know what you are doing.
escape_sandbox : true
# Advanced value that is useful when CopyPreviousMarkRange is used
# with multiline-prompts. This offset value is being added to the
# current cursor's line number minus 1 (i.e. the line above the current cursor).
#
# Default value is 0.
copy_last_mark_range_offset : 0
# Sets initial working directory when spawning a new terminal.
# A leading ~ is expanded to the user's home directory.
# Default value is the user's home directory.
initial_working_directory : "~"
# When this profile is *activated*, this flag decides
# whether or not the title bar will be shown
show_title_bar : true
# When this profile is *activated*, this flag decides
# whether or not the size indicator on resize will be shown.
size_indicator_on_resize : true
# When this profile is being *activated*, this flag decides
# whether or not to put the terminal's screen into fullscreen mode.
#
# It is activated during startup as well as when switching from another profile to this one.
fullscreen : false
# When this profile is *activated*, this flag decides
# whether or not to put the window into maximized mode.
maximized : false
bell :
# There is no sound for BEL character if set to "off".
# If set to "default" BEL character sound will be default sound.
# If set to path to a file then BEL sound will use that file. Example
# sound: "/home/user/Music/bell.wav"
sound : "default"
# Bell volume, a normalized value between 0.0 (silent) and 1.0 (loudest).
# Default: 1.0
volume : 1.0
# If this boolean is true, a window alert will be raised with each bell
alert : true
# Defines the class part of the WM_CLASS property of the window.
wm_class : "contour"
# Tells Contour how to handle Option-Key events on MacOS.
# This value is ignored on other platforms.
#
# Default: false
option_as_alt : false
# Environment variables to be passed to the shell.
# environment:
# TERM: contour
# COLORTERM: truecolor
# Determines the terminal type that is being advertised.
# Possible values are:
# - VT100
# - VT220
# - VT240
# - VT330
# - VT340
# - VT320
# - VT420
# - VT510
# - VT520
# - VT525
# Default: VT525
terminal_id : VT525
# Defines a list of DEC modes to explicitly and permanently disable/enable support for.
#
# This is a developer-users-only option that may possibly help investigating problems.
# This option may also be used by regular users if they're asked to in order to disable
# a broken functionality. This is something we hardly try to avoid, of course.
#
# This can be an object with each key being the DEC mode number and its value a boolean,
# indicating whether this DEC mode is permanently set (enabled) or unset (disabled).
#
# Example:
#
# frozen_dec_modes:
# 2026: false
# 2027: true
#
# Default: (empty object)
#frozen_dec_modes:
# Defines the number of milliseconds to wait before
# actually executing the LF (linefeed) control code
# in case DEC mode `DECSCLM` is enabled.
#
# Default: 100
slow_scrolling_time : 100
# Determines the initial terminal size in characters.
terminal_size :
columns : 80
lines : 25
# Window margins
#
# The margin values are applied on both sides and are given in pixels
# with DPI yet to be applied to these values.
margins :
# Horizontal (left/right) margins.
horizontal : 5
# Vertical (top/bottom) margins.
vertical : 5
history :
# Number of lines to preserve (-1 for infinite).
limit : 1000
# Boolean indicating whether or not to scroll down to the bottom on screen updates.
auto_scroll_on_update : true
# Number of lines to scroll on ScrollUp & ScrollDown events.
# Default: 3
scroll_multiplier : 3
# visual scrollbar support
scrollbar :
# scroll bar position: Left, Right, Hidden (ignore-case)
position : Hidden
# whether or not to hide the scrollbar when in alt-screen.
hide_in_alt_screen : true
# mouse setting
mouse :
# whether or not to hide mouse when typing
#
# Default value: true
hide_while_typing : true
# Some VT sequences should need access permissions.
#
# These can be to:
# - allow Allows the given functionality
# - deny Denies the given functionality
# - ask Asks the user interactively via popup dialog for permission of the given action.
#
# Default for all of these entries should be: "ask".
permissions :
# Allows changing the font via `OSC 50 ; Pt ST`.
change_font : ask
# Allows capturing the screen buffer via `CSI > Pm ; Ps ; Pc ST`.
# The response can be read from stdin as sequence `OSC 314 ; <screen capture> ST`
capture_buffer : ask
# Allows displaying the "Host Writable Statusline" programmatically using `DECSSDT 2`.
display_host_writable_statusline : ask
# If enabled, and you double-click on a word in the primary screen,
# all other words matching this word will be highlighted as well.
# So the double-clicked word will be selected as well as highlighted, along with
# all other words being simply highlighted.
#
# This is currently implemented by initiating a search on the double-clicked word.
# Therefore one can even use FocusNextSearchMatch and FocusPreviousSearchMatch to
# jump to the next/previous same word, also outside of the current viewport.
#
# Default: true
highlight_word_and_matches_on_double_click : true
# Font related configuration (font face, styles, size, rendering mode).
font :
# Initial font size in pixels.
size : 12
# Font Locator API
# Selects an engine to use for locating font files on the system.
# This is implicitly also responsible for font fallback
# Possible values are:
# - native : automatically choose the best available on the current platform
# - fontconfig : uses fontconfig to select fonts
# - CoreText : uses OS/X CoreText to select fonts.
# - DirectWrite : selects DirectWrite engine (Windows only)
locator : native
# Text shaping related settings
text_shaping :
# Selects which text shaping and font rendering engine to use.
# Supported values are:
# - native : automatically choose the best available on the current platform.
# - DirectWrite : selects DirectWrite engine (Windows only)
# - CoreText : selects CoreText engine (Mac OS/X only) (currently not implemented)
# - OpenShaper : selects OpenShaper (harfbuzz/freetype/fontconfig, available on all
# platforms)
engine : native
# Uses builtin textures for pixel-perfect box drawing.
# If disabled, the font's provided box drawing characters
# will be used (Default: true).
builtin_box_drawing : true
# Font render modes tell the font rasterizer engine what rendering technique to use.
#
# Modes available are:
# - lcd Uses a subpixel rendering technique optimized for LCD displays.
# - light Uses a subpixel rendering technique in gray-scale.
# - gray Uses standard gray-scaled anti-aliasing.
# - monochrome Uses pixel-perfect bitmap rendering.
render_mode : gray
# Indicates whether or not to include *only* monospace fonts in the font and
# font-fallback list (Default: true).
strict_spacing : true
# Font family to use for displaying text.
#
# A font can be either described in detail as below or as a
# simple string value (e.g. "monospace" with the appropriate
# weight/slant applied automatically).
regular :
# Font family defines the font family name, such as:
# Fira Code", "Courier New", or "monospace" (default).
family : "monospace"
# Font weight can be one of:
# thin, extra_light, light, demilight, book, normal,
# medium, demibold, bold, extra_bold, black, extra_black.
weight : regular
# Font slant can be one of: normal, italic, oblique.
slant : normal
# Set of optional font features to be enabled. This
# is usually a 4-letter code, such as ss01 or ss02 etc.
#
# Please see your font's documentation to find out what it
# supports.
#
# Default: []
features : [ ]
# If bold/italic/bold_italic are not explicitly specified, the regular font with
# the respective weight and slant will be used.
#bold: "Hack"
#italic: "Hack"
#bold_italic: "Hack"
# This is a special font to be used for displaying unicode symbols
# that are to be rendered in emoji presentation.
# Defaults to "emoji".
emoji : "emoji"
# Indicates whether or not bold text should be rendered in bright colors,
# for indexed colors.
#
# If disabled, normal color will be used instead.
#
# Default: false
draw_bold_text_with_bright_colors : false
# Terminal cursor display configuration
cursor :
# Supported shapes are:
#
# - block a filled rectangle
# - rectangle just the outline of a block
# - underscore a line under the text
# - bar: the well known i-Beam
shape : "bar"
# Determines whether or not the cursor will be blinking over time.
blinking : false
# Blinking interval (in milliseconds) to use when cursor is blinking.
blinking_interval : 500
# vi-like normal-mode specific settings.
# Note, currently only the cursor can be customized.
normal_mode :
cursor :
shape : block
blinking : false
blinking_interval : 500
# vi-like visual/visual-line/visual-block mode specific settings.
# Note, currently only the cursor can be customized.
visual_mode :
cursor :
shape : block
blinking : false
blinking_interval : 500
# Time duration in milliseconds for which yank highlight is shown.
vi_mode_highlight_timeout : 300
# Configures a `scrolloff` for cursor movements in normal and visual (block) modes.
#
# Default: 8
vi_mode_scrolloff : 8
status_line :
# Either none or indicator.
# This only reflects the initial state of the status line, as it can
# be changed at any time during runtime by the user or by an application.
display : none
# Position to place the status line to, if it is to be shown.
# This can be either value `top` or value `bottom`.
# Default: bottom
position : bottom
# Synchronize the window title with the Host Writable status_line if
# and only if the host writable status line was denied to be shown.
# Default: false
sync_to_window_title : false
# Background configuration
background :
# Background opacity to use. A value of 1.0 means fully opaque whereas 0.0 means fully
# transparent. Only values between 0.0 and 1.0 are allowed.
opacity : 1.0
# Some platforms can blur the transparent background (currently only Windows 10 is supported).
blur : false
# Specifies a colorscheme to use (alternatively the colors can be inlined).
#
# This can be either the name to a single colorscheme to always use,
# or a map with two keys (dark and light) to determine the color scheme to use for each.
#
# The dark color scheme is used when the system is configured to prefer dark mode and light theme otherwise.
#
# Default: "default"
colors :
light : default
dark : default
# Hyperlinks (via OSC-8) can be stylized and colorized on hover.
# Possible values: underline, dotted-underline, double-underline, curly-underline,
# dashed-underline, overline, crossed-out, framed, encircle (if implemented)
hyperlink_decoration :
normal : dotted
hover : underline
my_profile :
2024-07-25 06:20:58 +01:00
shell : "zsh"
2024-07-12 10:20:53 +01:00
escape_sandbox : true
# Advanced value that is useful when CopyPreviousMarkRange is used
# with multiline-prompts. This offset value is being added to the
# current cursor's line number minus 1 (i.e. the line above the current cursor).
#
# Default value is 0.
copy_last_mark_range_offset : 0
# Sets initial working directory when spawning a new terminal.
# A leading ~ is expanded to the user's home directory.
# Default value is the user's home directory.
initial_working_directory : "~"
# When this profile is *activated*, this flag decides
# whether or not the title bar will be shown
2024-07-25 12:26:15 +01:00
show_title_bar : true
2024-07-12 10:20:53 +01:00
# When this profile is *activated*, this flag decides
# whether or not the size indicator on resize will be shown.
size_indicator_on_resize : true
# When this profile is being *activated*, this flag decides
# whether or not to put the terminal's screen into fullscreen mode.
#
# It is activated during startup as well as when switching from another profile to this one.
fullscreen : false
# When this profile is *activated*, this flag decides
# whether or not to put the window into maximized mode.
2024-07-30 13:46:11 +01:00
maximized : true
2024-07-12 10:20:53 +01:00
bell :
sound : "default"
volume : 0.0
alert : true
# Defines the class part of the WM_CLASS property of the window.
wm_class : "contour"
option_as_alt : false
# Environment variables to be passed to the shell.
# environment:
# TERM: contour
# COLORTERM: truecolor
# Determines the terminal type that is being advertised.
# Possible values are:
# - VT100
# - VT220
# - VT240
# - VT330
# - VT340
# - VT320
# - VT420
# - VT510
# - VT520
# - VT525
# Default: VT525
terminal_id : VT525
# Defines the number of milliseconds to wait before
# actually executing the LF (linefeed) control code
# in case DEC mode `DECSCLM` is enabled.
#
# Default: 100
slow_scrolling_time : 100
# Determines the initial terminal size in characters.
terminal_size :
columns : 80
lines : 25
margins :
horizontal : 0
vertical : 0
history :
# Number of lines to preserve (-1 for infinite).
limit : 10000
# Boolean indicating whether or not to scroll down to the bottom on screen updates.
auto_scroll_on_update : false
# Number of lines to scroll on ScrollUp & ScrollDown events.
# Default: 3
scroll_multiplier : 3
# visual scrollbar support
scrollbar :
# scroll bar position: Left, Right, Hidden (ignore-case)
position : Hidden
# whether or not to hide the scrollbar when in alt-screen.
hide_in_alt_screen : true
mouse :
hide_while_typing : true
# Some VT sequences should need access permissions.
#
# These can be to:
# - allow Allows the given functionality
# - deny Denies the given functionality
# - ask Asks the user interactively via popup dialog for permission of the given action.
#
# Default for all of these entries should be: "ask".
permissions :
# Allows changing the font via `OSC 50 ; Pt ST`.
change_font : ask
# Allows capturing the screen buffer via `CSI > Pm ; Ps ; Pc ST`.
# The response can be read from stdin as sequence `OSC 314 ; <screen capture> ST`
capture_buffer : ask
# Allows displaying the "Host Writable Statusline" programmatically using `DECSSDT 2`.
display_host_writable_statusline : ask
highlight_word_and_matches_on_double_click : true
# Font related configuration (font face, styles, size, rendering mode).
font :
# Initial font size in pixels.
2024-07-30 13:46:11 +01:00
size : 18
2024-07-12 10:20:53 +01:00
# Font Locator API
# Selects an engine to use for locating font files on the system.
# This is implicitly also responsible for font fallback
# Possible values are:
# - native : automatically choose the best available on the current platform
# - fontconfig : uses fontconfig to select fonts
# - CoreText : uses OS/X CoreText to select fonts.
# - DirectWrite : selects DirectWrite engine (Windows only)
locator : native
# Text shaping related settings
text_shaping :
# Selects which text shaping and font rendering engine to use.
# Supported values are:
# - native : automatically choose the best available on the current platform.
# - DirectWrite : selects DirectWrite engine (Windows only)
# - CoreText : selects CoreText engine (Mac OS/X only) (currently not implemented)
# - OpenShaper : selects OpenShaper (harfbuzz/freetype/fontconfig, available on all
# platforms)
engine : native
# Uses builtin textures for pixel-perfect box drawing.
# If disabled, the font's provided box drawing characters
# will be used (Default: true).
2024-07-13 11:26:04 +01:00
builtin_box_drawing : false
2024-07-12 10:20:53 +01:00
# Font render modes tell the font rasterizer engine what rendering technique to use.
#
# Modes available are:
# - lcd Uses a subpixel rendering technique optimized for LCD displays.
# - light Uses a subpixel rendering technique in gray-scale.
# - gray Uses standard gray-scaled anti-aliasing.
# - monochrome Uses pixel-perfect bitmap rendering.
render_mode : gray
# Indicates whether or not to include *only* monospace fonts in the font and
# font-fallback list (Default: true).
strict_spacing : true
# Font family to use for displaying text.
#
# A font can be either described in detail as below or as a
# simple string value (e.g. "monospace" with the appropriate
# weight/slant applied automatically).
regular :
# Font family defines the font family name, such as:
# Fira Code", "Courier New", or "monospace" (default).
family : "BerkeleyMono Nerd Font"
# Font weight can be one of:
# thin, extra_light, light, demilight, book, normal,
# medium, demibold, bold, extra_bold, black, extra_black.
weight : regular
# Font slant can be one of: normal, italic, oblique.
slant : normal
# Set of optional font features to be enabled. This
# is usually a 4-letter code, such as ss01 or ss02 etc.
#
# Please see your font's documentation to find out what it
# supports.
#
# Default: []
2024-07-13 11:26:04 +01:00
features : [ ]
2024-07-12 10:20:53 +01:00
2024-08-03 11:19:28 +01:00
# bold: "BerkeleyMono Nerd Font Bold"
# italic: "BerkeleyMono Nerd Font Italic"
# bold_italic: "BerkeleyMono Nerd Font Bold Italic"
2024-07-12 10:20:53 +01:00
# This is a special font to be used for displaying unicode symbols
# that are to be rendered in emoji presentation.
# Defaults to "emoji".
2024-07-13 11:26:04 +01:00
emoji : "BerkeleyMono Nerd Font"
2024-07-12 10:20:53 +01:00
2024-07-19 17:38:37 +01:00
draw_bold_text_with_bright_colors : true
2024-07-12 10:20:53 +01:00
# Terminal cursor display configuration
cursor :
# Supported shapes are:
#
# - block a filled rectangle
# - rectangle just the outline of a block
# - underscore a line under the text
# - bar: the well known i-Beam
shape : "bar"
blinking : false
blinking_interval : 500
# vi-like normal-mode specific settings.
# Note, currently only the cursor can be customized.
normal_mode :
cursor :
shape : block
blinking : false
blinking_interval : 500
# vi-like visual/visual-line/visual-block mode specific settings.
# Note, currently only the cursor can be customized.
visual_mode :
cursor :
shape : block
blinking : false
blinking_interval : 500
# Time duration in milliseconds for which yank highlight is shown.
vi_mode_highlight_timeout : 300
# Configures a `scrolloff` for cursor movements in normal and visual (block) modes.
#
# Default: 8
vi_mode_scrolloff : 8
status_line :
# Either none or indicator.
# This only reflects the initial state of the status line, as it can
# be changed at any time during runtime by the user or by an application.
display : indicator
# Position to place the status line to, if it is to be shown.
# This can be either value `top` or value `bottom`.
# Default: bottom
position : bottom
# Synchronize the window title with the Host Writable status_line if
# and only if the host writable status line was denied to be shown.
# Default: false
sync_to_window_title : true
# Background configuration
background :
opacity : 1.0
blur : false
colors :
light : default
dark : default
# Hyperlinks (via OSC-8) can be stylized and colorized on hover.
# Possible values: underline, dotted-underline, double-underline, curly-underline,
# dashed-underline, overline, crossed-out, framed, encircle (if implemented)
hyperlink_decoration :
normal : dotted
hover : underline
# Color Profiles
# --------------
#
# Here you can configure your color profiles, whereas a color can be expressed in standard web format,
# with a leading # followed by red/green/blue values, 7 characters in total.
# You may alternatively use 0x as prefix instead of #.
# For example 0x102030 is equal to '#102030'.
color_schemes :
default :
# Default colors
default :
# Default background color (this can be made transparent, see above).
background : '#1a1716'
# Default foreground text color.
foreground : '#d0d0d0'
# Default foreground text color when bold(/bright) mode is on.
bright_foreground : '#FFFFFF'
# Default foreground text color when dim mode is on.
dimmed_foreground : '#808080'
# Background image support.
background_image :
# Full path to the image to use as background.
#
# Default: empty string (disabled)
# path: '/Users/trapni/Pictures/bg.png'
# Image opacity to be applied to make the image not look to intense
# and not get too distracted by the background image.
# Default: 0.5
opacity : 0.5
# Optionally blurs background image to make it less distracting
# and keep the focus on the actual terminal contents.
#
# Default: false
blur : false
# Mandates the color of the cursor and potentially overridden text.
#
# The color can be specified in RGB as usual, plus
# - CellForeground: Selects the cell's foreground color.
# - CellBackground: Selects the cell's background color.
cursor :
# Specifies the color to be used for the actual cursor shape.
#
# Default: CellForeground
default : '#A7E6FF'
# Specifies the color to be used for the characters that would
# be covered otherwise.
#
# Default: CellBackground
text : '#000000'
# color to pick for hyperlinks decoration, when hovering
hyperlink_decoration :
normal : '#f0f000'
hover : '#ff0000'
# Color to pick for vi_mode highlights.
# The value format is equivalent to how selection colors and alpha contribution is defined.
vi_mode_highlight :
foreground : CellForeground
foreground_alpha : 1.0
background : '#ffa500'
background_alpha : 0.5
# Color override for the current cursor's line when in vi_mode:
# The value format is equivalent to how selection colors and alpha contribution is defined.
# To disable cursorline in vi_mode, set foreground to CellForeground and background to CellBackground.
vi_mode_cursorline :
foreground : '#ffffff'
foreground_alpha : 0.2
background : '#808080'
background_alpha : 0.4
# The text selection color can be customized here.
# Leaving a value empty will default to the inverse of the content's color values.
#
# The color can be specified in RGB as usual, plus
# - CellForeground: Selects the cell's foreground color.
# - CellBackground: Selects the cell's background color.
selection :
# Specifies the color to be used for the selected text.
#
# Default: CellBackground
foreground : CellForeground
# Specifies the alpha value (between 0.0 and 1.0) the configured foreground color
# will contribute to the original color.
#
# A value of 1.0 will paint over, whereas a value of 0.5 will give
# a look of a half-transparently painted grid cell.
foreground_alpha : 1.0
# Specifies the color to be used for the selected background.
#
# Default: CellForeground
background : '#4040f0'
# Specifies the alpha value (between 0.0 and 1.0) the configured background color
# will contribute to the original color.
#
# A value of 1.0 will paint over, whereas a value of 0.5 will give
# a look of a half-transparently painted grid cell.
background_alpha : 0.5
# Search match highlighting. Similar to selection highlighting.
search_highlight :
foreground : CellBackground
background : CellForeground
foreground_alpha : 1.0
background_alpha : 1.0
# Search match highlighting (focused term). Similar to selection highlighting.
search_highlight_focused :
foreground : CellBackground
background : CellForeground
foreground_alpha : 1.0
background_alpha : 1.0
# Coloring for the word that is highlighted due to double-clicking it.
#
# The format is similar to selection highlighting.
word_highlight_current :
foreground : CellForeground
background : '#909090'
foreground_alpha : 1.0
background_alpha : 0.5
# Coloring for the word that is highlighted due to double-clicking
# another word that matches this word.
#
# The format is similar to selection highlighting.
word_highlight_other :
foreground : CellForeground
background : '#909090'
foreground_alpha : 1.0
background_alpha : 0.5
# Defines the colors to be used for the Indicator status line.
# Values must be in RGB form.
indicator_statusline :
# Default: default background
foreground : '#808080'
# Default: default foreground
background : '#000000'
# Alternate colors to be used for the indicator status line when
# this terminal is currently not in focus.
indicator_statusline_inactive :
# Default: default background
foreground : '#808080'
# Default: default foreground
background : '#000000'
# Colors for the IME (Input Method Editor) area.
input_method_editor :
# Default: default #FFFFFF
foreground : '#FFFFFF'
# Default: default #FF0000
background : '#FF0000'
# Normal colors
normal :
black : '#000000'
red : '#c63939'
green : '#00a000'
yellow : '#a0a000'
blue : '#4d79ff'
magenta : '#ff66ff'
cyan : '#00a0a0'
white : '#c0c0c0'
# Bright colors
bright :
black : '#707070'
red : '#ff0000'
green : '#00ff00'
yellow : '#ffff00'
blue : '#0000ff'
magenta : '#ff00ff'
cyan : '#00ffff'
white : '#ffffff'
# Dim (faint) colors, if not set, they're automatically computed based on normal colors.
# dim:
# black: '#1d1f21'
# red: '#cc342b'
# green: '#198844'
# yellow: '#fba922'
# blue: '#3971ed'
# magenta: '#a36ac7'
# cyan: '#3971ed'
# white: '#c5c8c6'
# Key Bindings
# ------------
#
# In this section you can customize key bindings.
# Each array element in `input_mapping` represents one key binding,
# whereas `mods` represents an array of keyboard modifiers that must be pressed - as well as
# the `key` or `mouse` - in order to activate the corresponding action,
#
# Additionally one can filter input mappings based on special terminal modes using the `modes` option:
# - Alt : The terminal is currently in alternate screen buffer, otherwise it is in primary screen buffer.
# - AppCursor : The application key cursor mode is enabled (otherwise it's normal cursor mode).
# - AppKeypad : The application keypad mode is enabled (otherwise it's the numeric keypad mode).
# - Select : The terminal has currently an active grid cell selection (such as selected text).
# - Insert : The Insert input mode is active, that is the default and one way to test
# that the input mode is not in normal mode or any of the visual select modes.
# - Search : There is a search term currently being edited or already present.
# - Trace : The terminal is currently in trace-mode, i.e., each VT sequence can be interactively
# single-step executed using custom actions. See TraceEnter/TraceStep/TraceLeave actions.
#
# You can combine these modes by concatenating them via | and negate a single one
# by prefixing with ~.
#
# The `modes` option defaults to not filter at all (the input mappings always
# match based on modifier and key press / mouse event).
#
# `key` represents keys on your keyboard, and `mouse` represents buttons
# as well as the scroll wheel.
#
# Modifiers:
# - Alt
# - Control
# - Shift
# - Meta (this is the Windows key on Windows OS, and the Command key on OS/X, and Meta on anything else)
#
# Keys can be expressed case-insensitively symbolic:
# APOSTROPHE, ADD, BACKSLASH, COMMA, DECIMAL, DIVIDE, EQUAL, LEFT_BRACKET,
# MINUS, MULTIPLY, PERIOD, RIGHT_BRACKET, SEMICOLON, SLASH, SUBTRACT, SPACE
# Enter, Backspace, Tab, Escape, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12,
# DownArrow, LeftArrow, RightArrow, UpArrow, Insert, Delete, Home, End, PageUp, PageDown,
# Numpad_Divide, Numpad_Multiply, Numpad_Subtract, Numpad_Add, Numpad_Decimal, Numpad_Enter, Numpad_Equal,
# Numpad_0, Numpad_1, Numpad_2, Numpad_3, Numpad_4,
# Numpad_5, Numpad_6, Numpad_7, Numpad_8, Numpad_9
# or in case of standard characters, just the character.
#
# Mouse buttons can be one of the following self-explanatory ones:
# Left, Middle, Right, WheelUp, WheelDown
#
# Actions:
# - CancelSelection Cancels currently active selection, if any.
# - ChangeProfile Changes the profile to the given profile `name`.
# - ClearHistoryAndReset Clears the history, performs a terminal hard reset and attempts to force a redraw of the currently running application.
# - CopyPreviousMarkRange Copies the most recent range that is delimited by vertical line marks into clipboard.
# - CopySelection Copies the current selection into the clipboard buffer.
# - DecreaseFontSize Decreases the font size by 1 pixel.
# - DecreaseOpacity Decreases the default-background opacity by 5%.
# - FocusNextSearchMatch Focuses the next search match (if any).
# - FocusPreviousSearchMatch Focuses the next previous match (if any).
# - FollowHyperlink Follows the hyperlink that is exposed via OSC 8 under the current cursor position.
# - IncreaseFontSize Increases the font size by 1 pixel.
# - IncreaseOpacity Increases the default-background opacity by 5%.
# - NewTerminal Spawns a new terminal at the current terminals current working directory.
# - NoSearchHighlight Disables current search highlighting, if anything is still highlighted due to a prior search.
# - OpenConfiguration Opens the configuration file.
# - OpenFileManager Opens the current working directory in a system file manager.
# - OpenSelection Open the current terminal selection with the default system application (eg; xdg-open)
# - PasteClipboard Pastes clipboard to standard input. Pass boolean parameter 'strip' to indicate whether or not to strip repetitive whitespaces down to one and newlines to whitespaces.
# - PasteSelection Pastes current selection to standard input.
# - Quit Quits the application.
# - ReloadConfig Forces a configuration reload.
# - ResetConfig Overwrites current configuration with builtin default configuration and loads it. Attention, all your current configuration will be lost due to overwrite!
# - ResetFontSize Resets font size to what is configured in the config file.
# - ScreenshotVT Takes a screenshot in form of VT escape sequences.
# - ScrollDown Scrolls down by the multiplier factor.
# - ScrollMarkDown Scrolls one mark down (if none present, bottom of the screen)
# - ScrollMarkUp Scrolls one mark up
# - ScrollOneDown Scrolls down by exactly one line.
# - ScrollOneUp Scrolls up by exactly one line.
# - ScrollPageDown Scrolls a page down.
# - ScrollPageUp Scrolls a page up.
# - ScrollToBottom Scrolls to the bottom of the screen buffer.
# - ScrollToTop Scrolls to the top of the screen buffer.
# - ScrollUp Scrolls up by the multiplier factor.
# - SearchReverse Initiates search mode (starting to search at current cursor position, moving upwards).
# - SendChars Writes given characters in `chars` member to the applications input.
# - ToggleAllKeyMaps Disables/enables responding to all keybinds (this keybind will be preserved when disabling all others).
# - ToggleFullScreen Enables/disables full screen mode.
# - ToggleInputProtection Enables/disables terminal input protection.
# - ToggleStatusLine Shows/hides the VT320 compatible Indicator status line.
# - ToggleTitleBar Shows/Hides titlebar
# - TraceBreakAtEmptyQueue Executes any pending VT sequence from the VT sequence buffer in trace mode, then waits.
# - TraceEnter Enables trace mode, suspending execution until explicitly requested to continue (See TraceLeave and TraceStep).
# - TraceLeave Disables trace mode. Any pending VT sequence will be flushed out and normal execution will be resumed.
# - TraceStep Executes a single VT sequence that is to be executed next.
# - ViNormalMode Enters/Leaves Vi-like normal mode. The cursor can then be moved via h/j/k/l movements in normal mode and text can be selected via v, yanked via y, and clipboard pasted via p.
# - WriteScreen Writes VT sequence in `chars` member to the screen (bypassing the application).
input_mapping :
- { mods: [Control], mouse: Left, action : FollowHyperlink }
- { mods: [], mouse: Middle, action : PasteSelection }
- { mods: [], mouse: WheelDown, action : ScrollDown }
- { mods: [], mouse: WheelUp, action : ScrollUp }
- { mods: [Alt], key: Enter, action : ToggleFullscreen }
- { mods: [Alt], mouse: WheelDown, action : DecreaseOpacity }
- { mods: [Alt], mouse: WheelUp, action : IncreaseOpacity }
- { mods: [Control, Alt], key: S, action : ScreenshotVT }
- { mods: [Control, Shift], key: Plus, action : IncreaseFontSize }
- { mods: [Control], key: '0', action : ResetFontSize }
- { mods: [Control, Shift], key: Minus, action : DecreaseFontSize }
- { mods: [Control, Shift], key: '_', action : DecreaseFontSize }
- { mods: [Control, Shift], key: N, action : NewTerminal }
- { mods: [Control, Shift], key: V, action: PasteClipboard, strip : false }
- { mods: [Control, Alt], key: V, action: PasteClipboard, strip : true }
- { mods: [Control], key: C, action: CopySelection, mode : 'Select|Insert' }
- { mods: [Control], key: C, action: CancelSelection, mode : 'Select|Insert' }
- { mods: [Control], key: V, action: PasteClipboard, strip: false, mode : 'Select|Insert' }
- { mods: [Control], key: V, action: CancelSelection, mode : 'Select|Insert' }
- { mods: [], key: Escape, action: CancelSelection, mode : 'Select|Insert' }
- { mods: [Control, Shift], key: Space, action: ViNormalMode, mode : 'Insert' }
- { mods: [Control, Shift], key: Comma, action : OpenConfiguration }
- { mods: [Control, Shift], key: Q, action : Quit }
- { mods: [Control], mouse: WheelDown, action : DecreaseFontSize }
- { mods: [Control], mouse: WheelUp, action : IncreaseFontSize }
- { mods: [Shift], key: DownArrow, action : ScrollOneDown }
- { mods: [Shift], key: End, action : ScrollToBottom }
- { mods: [Shift], key: Home, action : ScrollToTop }
- { mods: [Shift], key: PageDown, action : ScrollPageDown }
- { mods: [Shift], key: PageUp, action : ScrollPageUp }
- { mods: [Shift], key: UpArrow, action : ScrollOneUp }
- { mods: [Control, Alt], key: K, action: ScrollMarkUp, mode : "~Alt" }
- { mods: [Control, Alt], key: J, action: ScrollMarkDown, mode : "~Alt" }
- { mods: [Shift], mouse: WheelDown, action : ScrollPageDown }
- { mods: [Shift], mouse: WheelUp, action : ScrollPageUp }
- { mods: [Control, Alt], key: O, action : OpenFileManager }
- { mods: [Control, Alt], key: '.', action : ToggleStatusLine }
- { mods: [Control, Shift], key: 'F', action : SearchReverse }
- { mods: [Control, Shift], key: 'H', action : NoSearchHighlight }
- { mods: [], key: 'F3', action : FocusNextSearchMatch }
- { mods: [Shift], key: 'F3', action : FocusPreviousSearchMatch }
# - { mods: [Control, Meta], key: 'E', action: TraceEnter, mode: "~Trace" }
# - { mods: [Control, Meta], key: 'E', action: TraceLeave, mode: "Trace" }
# - { mods: [Control, Meta], key: 'N', action: TraceStep, mode: "Trace" }
# - { mods: [Control, Meta], key: 'F', action: TraceBreakAtEmptyQueue, mode: "Trace" }
