mirror of
https://github.com/alacritty/alacritty.git
synced 2024-11-18 13:55:23 -05:00
5e22512fe6
Since the assumption is usually that bold text is drawn in bright colors, this might break some applications. However some other terminals have already taken this leap, which should lessen the impact for Alacritty. Since this might still be desired and necessary for certain applications, the config option is just switched to draw with normal colors by default, however the old behavior can still be restored. Fixes #2779.
569 lines
16 KiB
YAML
569 lines
16 KiB
YAML
# Configuration for Alacritty, the GPU enhanced terminal emulator.
|
|
|
|
# Any items in the `env` entry below will be added as
|
|
# environment variables. Some entries may override variables
|
|
# set by alacritty itself.
|
|
#env:
|
|
# TERM variable
|
|
#
|
|
# This value is used to set the `$TERM` environment variable for
|
|
# each instance of Alacritty. If it is not present, alacritty will
|
|
# check the local terminfo database and use `alacritty` if it is
|
|
# available, otherwise `xterm-256color` is used.
|
|
#TERM: xterm-256color
|
|
|
|
#window:
|
|
# Window dimensions (changes require restart)
|
|
#
|
|
# Specified in number of columns/lines, not pixels.
|
|
# If both are `0`, this setting is ignored.
|
|
#dimensions:
|
|
# columns: 0
|
|
# lines: 0
|
|
|
|
# Window position (changes require restart)
|
|
#
|
|
# Specified in number of pixels.
|
|
# If the position is not set, the window manager will handle the placement.
|
|
#position:
|
|
# x: 0
|
|
# y: 0
|
|
|
|
# Window padding (changes require restart)
|
|
#
|
|
# Blank space added around the window in pixels. This padding is scaled
|
|
# by DPI and the specified value is always added at both opposing sides.
|
|
#padding:
|
|
# x: 0
|
|
# y: 0
|
|
|
|
# Spread additional padding evenly around the terminal content.
|
|
#dynamic_padding: false
|
|
|
|
# Window decorations
|
|
#
|
|
# Values for `decorations`:
|
|
# - full: Borders and title bar
|
|
# - none: Neither borders nor title bar
|
|
#
|
|
# Values for `decorations` (macOS only):
|
|
# - transparent: Title bar, transparent background and title bar buttons
|
|
# - buttonless: Title bar, transparent background, but no title bar buttons
|
|
#decorations: full
|
|
|
|
# Startup Mode (changes require restart)
|
|
#
|
|
# Values for `startup_mode`:
|
|
# - Windowed
|
|
# - Maximized
|
|
# - Fullscreen
|
|
#
|
|
# Values for `startup_mode` (macOS only):
|
|
# - SimpleFullscreen
|
|
#startup_mode: Windowed
|
|
|
|
# Window title
|
|
#title: Alacritty
|
|
|
|
# Window class (Linux/BSD only):
|
|
#class:
|
|
# Application instance name
|
|
#instance: Alacritty
|
|
# General application class
|
|
#general: Alacritty
|
|
|
|
# GTK theme variant (Linux/BSD only)
|
|
#
|
|
# Override the variant of the GTK theme. Commonly supported values are `dark` and `light`.
|
|
# Set this to `None` to use the default theme variant.
|
|
#gtk_theme_variant: None
|
|
|
|
#scrolling:
|
|
# Maximum number of lines in the scrollback buffer.
|
|
# Specifying '0' will disable scrolling.
|
|
#history: 10000
|
|
|
|
# Number of lines the viewport will move for every line scrolled when
|
|
# scrollback is enabled (history > 0).
|
|
#multiplier: 3
|
|
|
|
# Spaces per Tab (changes require restart)
|
|
#
|
|
# This setting defines the width of a tab in cells.
|
|
#
|
|
# Some applications, like Emacs, rely on knowing about the width of a tab.
|
|
# To prevent unexpected behavior in these applications, it's also required to
|
|
# change the `it` value in terminfo when altering this setting.
|
|
#tabspaces: 8
|
|
|
|
# Font configuration
|
|
#font:
|
|
# Normal (roman) font face
|
|
#normal:
|
|
# Font family
|
|
#
|
|
# Default:
|
|
# - (macOS) Menlo
|
|
# - (Linux/BSD) monospace
|
|
# - (Windows) Consolas
|
|
#family: monospace
|
|
|
|
# The `style` can be specified to pick a specific face.
|
|
#style: Regular
|
|
|
|
# Bold font face
|
|
#bold:
|
|
# Font family
|
|
#
|
|
# If the bold family is not specified, it will fall back to the
|
|
# value specified for the normal font.
|
|
#family: monospace
|
|
|
|
# The `style` can be specified to pick a specific face.
|
|
#style: Bold
|
|
|
|
# Italic font face
|
|
#italic:
|
|
# Font family
|
|
#
|
|
# If the italic family is not specified, it will fall back to the
|
|
# value specified for the normal font.
|
|
#family: monospace
|
|
|
|
# The `style` can be specified to pick a specific face.
|
|
#style: Italic
|
|
|
|
# Bold italic font face
|
|
#bold_italic:
|
|
# Font family
|
|
#
|
|
# If the bold italic family is not specified, it will fall back to the
|
|
# value specified for the normal font.
|
|
#family: monospace
|
|
|
|
# The `style` can be specified to pick a specific face.
|
|
#style: Bold Italic
|
|
|
|
# Point size
|
|
#size: 11.0
|
|
|
|
# Offset is the extra space around each character. `offset.y` can be thought of
|
|
# as modifying the line spacing, and `offset.x` as modifying the letter spacing.
|
|
#offset:
|
|
# x: 0
|
|
# y: 0
|
|
|
|
# Glyph offset determines the locations of the glyphs within their cells with
|
|
# the default being at the bottom. Increasing `x` moves the glyph to the right,
|
|
# increasing `y` moves the glyph upwards.
|
|
#glyph_offset:
|
|
# x: 0
|
|
# y: 0
|
|
|
|
# Thin stroke font rendering (macOS only)
|
|
#
|
|
# Thin strokes are suitable for retina displays, but for non-retina screens
|
|
# it is recommended to set `use_thin_strokes` to `false`
|
|
#
|
|
# macOS >= 10.14.x:
|
|
#
|
|
# If the font quality on non-retina display looks bad then set
|
|
# `use_thin_strokes` to `true` and enable font smoothing by running the
|
|
# following command:
|
|
# `defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO`
|
|
#
|
|
# This is a global setting and will require a log out or restart to take
|
|
# effect.
|
|
#use_thin_strokes: true
|
|
|
|
# If `true`, bold text is drawn using the bright color variants.
|
|
#draw_bold_text_with_bright_colors: false
|
|
|
|
# Colors (Tomorrow Night Bright)
|
|
#colors:
|
|
# Default colors
|
|
#primary:
|
|
# background: '0x000000'
|
|
# foreground: '0xeaeaea'
|
|
|
|
# Bright and dim foreground colors
|
|
#
|
|
# The dimmed foreground color is calculated automatically if it is not present.
|
|
# If the bright foreground color is not set, or `draw_bold_text_with_bright_colors`
|
|
# is `false`, the normal foreground color will be used.
|
|
#dim_foreground: '0x9a9a9a'
|
|
#bright_foreground: '0xffffff'
|
|
|
|
# Cursor colors
|
|
#
|
|
# Colors which should be used to draw the terminal cursor. If these are unset,
|
|
# the cursor color will be the inverse of the cell color.
|
|
#cursor:
|
|
# text: '0x000000'
|
|
# cursor: '0xffffff'
|
|
|
|
# Selection colors
|
|
#
|
|
# Colors which should be used to draw the selection area. If selection
|
|
# background is unset, selection color will be the inverse of the cell colors.
|
|
# If only text is unset the cell text color will remain the same.
|
|
#selection:
|
|
# text: '0xeaeaea'
|
|
# background: '0x404040'
|
|
|
|
# Normal colors
|
|
#normal:
|
|
# black: '0x000000'
|
|
# red: '0xd54e53'
|
|
# green: '0xb9ca4a'
|
|
# yellow: '0xe6c547'
|
|
# blue: '0x7aa6da'
|
|
# magenta: '0xc397d8'
|
|
# cyan: '0x70c0ba'
|
|
# white: '0xeaeaea'
|
|
|
|
# Bright colors
|
|
#bright:
|
|
# black: '0x666666'
|
|
# red: '0xff3334'
|
|
# green: '0x9ec400'
|
|
# yellow: '0xe7c547'
|
|
# blue: '0x7aa6da'
|
|
# magenta: '0xb77ee0'
|
|
# cyan: '0x54ced6'
|
|
# white: '0xffffff'
|
|
|
|
# Dim colors
|
|
#
|
|
# If the dim colors are not set, they will be calculated automatically based
|
|
# on the `normal` colors.
|
|
#dim:
|
|
# black: '0x000000'
|
|
# red: '0x8c3336'
|
|
# green: '0x7a8530'
|
|
# yellow: '0x97822e'
|
|
# blue: '0x506d8f'
|
|
# magenta: '0x80638e'
|
|
# cyan: '0x497e7a'
|
|
# white: '0x9a9a9a'
|
|
|
|
# Indexed Colors
|
|
#
|
|
# The indexed colors include all colors from 16 to 256.
|
|
# When these are not set, they're filled with sensible defaults.
|
|
#
|
|
# Example:
|
|
# `- { index: 16, color: '0xff00ff' }`
|
|
#
|
|
#indexed_colors: []
|
|
|
|
# Visual Bell
|
|
#
|
|
# Any time the BEL code is received, Alacritty "rings" the visual bell. Once
|
|
# rung, the terminal background will be set to white and transition back to the
|
|
# default background color. You can control the rate of this transition by
|
|
# setting the `duration` property (represented in milliseconds). You can also
|
|
# configure the transition function by setting the `animation` property.
|
|
#
|
|
# Values for `animation`:
|
|
# - Ease
|
|
# - EaseOut
|
|
# - EaseOutSine
|
|
# - EaseOutQuad
|
|
# - EaseOutCubic
|
|
# - EaseOutQuart
|
|
# - EaseOutQuint
|
|
# - EaseOutExpo
|
|
# - EaseOutCirc
|
|
# - Linear
|
|
#
|
|
# Specifying a `duration` of `0` will disable the visual bell.
|
|
#visual_bell:
|
|
# animation: EaseOutExpo
|
|
# duration: 0
|
|
# color: '0xffffff'
|
|
|
|
# Background opacity
|
|
#
|
|
# Window opacity as a floating point number from `0.0` to `1.0`.
|
|
# The value `0.0` is completely transparent and `1.0` is opaque.
|
|
#background_opacity: 1.0
|
|
|
|
#selection:
|
|
#semantic_escape_chars: ",│`|:\"' ()[]{}<>\t"
|
|
|
|
# When set to `true`, selected text will be copied to the primary clipboard.
|
|
#save_to_clipboard: false
|
|
|
|
# Allow terminal applications to change Alacritty's window title.
|
|
#dynamic_title: true
|
|
|
|
#cursor:
|
|
# Cursor style
|
|
#
|
|
# Values for `style`:
|
|
# - ▇ Block
|
|
# - _ Underline
|
|
# - | Beam
|
|
#style: Block
|
|
|
|
# If this is `true`, the cursor will be rendered as a hollow box when the
|
|
# window is not focused.
|
|
#unfocused_hollow: true
|
|
|
|
# Live config reload (changes require restart)
|
|
#live_config_reload: true
|
|
|
|
# Shell
|
|
#
|
|
# You can set `shell.program` to the path of your favorite shell, e.g. `/bin/fish`.
|
|
# Entries in `shell.args` are passed unmodified as arguments to the shell.
|
|
#
|
|
# Default:
|
|
# - (macOS) /bin/bash --login
|
|
# - (Linux/BSD) user login shell
|
|
# - (Windows) powershell
|
|
#shell:
|
|
# program: /bin/bash
|
|
# args:
|
|
# - --login
|
|
|
|
# Startup directory
|
|
#
|
|
# Directory the shell is started in. If this is unset, or `None`, the working
|
|
# directory of the parent process will be used.
|
|
#working_directory: None
|
|
|
|
# WinPTY backend (Windows only)
|
|
#
|
|
# Alacritty defaults to using the newer ConPTY backend if it is available,
|
|
# since it resolves a lot of bugs and is quite a bit faster. If it is not
|
|
# available, the the WinPTY backend will be used instead.
|
|
#
|
|
# Setting this option to `true` makes Alacritty use the legacy WinPTY backend,
|
|
# even if the ConPTY backend is available.
|
|
#winpty_backend: false
|
|
|
|
# Send ESC (\x1b) before characters when alt is pressed.
|
|
#alt_send_esc: true
|
|
|
|
#debug:
|
|
# Display the time it takes to redraw each frame.
|
|
#render_timer: false
|
|
|
|
# Keep the log file after quitting Alacritty.
|
|
#persistent_logging: false
|
|
|
|
# Log level
|
|
#
|
|
# Values for `log_level`:
|
|
# - None
|
|
# - Error
|
|
# - Warn
|
|
# - Info
|
|
# - Debug
|
|
# - Trace
|
|
#log_level: Warn
|
|
|
|
# Print all received window events.
|
|
#print_events: false
|
|
|
|
# Record all characters and escape sequences as test data.
|
|
#ref_test: false
|
|
|
|
#mouse:
|
|
# Click settings
|
|
#
|
|
# The `double_click` and `triple_click` settings control the time
|
|
# alacritty should wait for accepting multiple clicks as one double
|
|
# or triple click.
|
|
#double_click: { threshold: 300 }
|
|
#triple_click: { threshold: 300 }
|
|
|
|
# If this is `true`, the cursor is temporarily hidden when typing.
|
|
#hide_when_typing: false
|
|
|
|
#url:
|
|
# URL launcher
|
|
#
|
|
# This program is executed when clicking on a text which is recognized as a URL.
|
|
# The URL is always added to the command as the last parameter.
|
|
#
|
|
# When set to `None`, URL launching will be disabled completely.
|
|
#
|
|
# Default:
|
|
# - (macOS) open
|
|
# - (Linux/BSD) xdg-open
|
|
# - (Windows) explorer
|
|
#launcher:
|
|
# program: xdg-open
|
|
# args: []
|
|
|
|
# URL modifiers
|
|
#
|
|
# These are the modifiers that need to be held down for opening URLs when clicking
|
|
# on them. The available modifiers are documented in the key binding section.
|
|
#modifiers: None
|
|
|
|
# Mouse bindings
|
|
#
|
|
# Mouse bindings are specified as a list of objects, much like the key
|
|
# bindings further below.
|
|
#
|
|
# To trigger mouse bindings when an application running within Alacritty captures the mouse, the
|
|
# `Shift` modifier is automatically added as a requirement.
|
|
#
|
|
# Each mouse binding will specify a:
|
|
#
|
|
# - `mouse`:
|
|
#
|
|
# - Middle
|
|
# - Left
|
|
# - Right
|
|
# - Numeric identifier such as `5`
|
|
#
|
|
# - `action` (see key bindings)
|
|
#
|
|
# And optionally:
|
|
#
|
|
# - `mods` (see key bindings)
|
|
#mouse_bindings:
|
|
# - { mouse: Middle, action: PasteSelection }
|
|
|
|
# Key bindings
|
|
#
|
|
# Key bindings are specified as a list of objects. For example, this is the
|
|
# default paste binding:
|
|
#
|
|
# `- { key: V, mods: Control|Shift, action: Paste }`
|
|
#
|
|
# Each key binding will specify a:
|
|
#
|
|
# - `key`: Identifier of the key pressed
|
|
#
|
|
# - A-Z
|
|
# - F1-F24
|
|
# - Key0-Key9
|
|
#
|
|
# A full list with available key codes can be found here:
|
|
# https://docs.rs/glutin/*/glutin/event/enum.VirtualKeyCode.html#variants
|
|
#
|
|
# Instead of using the name of the keys, the `key` field also supports using
|
|
# the scancode of the desired key. Scancodes have to be specified as a
|
|
# decimal number. This command will allow you to display the hex scancodes
|
|
# for certain keys:
|
|
#
|
|
# `showkey --scancodes`.
|
|
#
|
|
# Then exactly one of:
|
|
#
|
|
# - `chars`: Send a byte sequence to the running application
|
|
#
|
|
# The `chars` field writes the specified string to the terminal. This makes
|
|
# it possible to pass escape sequences. To find escape codes for bindings
|
|
# like `PageUp` (`"\x1b[5~"`), you can run the command `showkey -a` outside
|
|
# of tmux. Note that applications use terminfo to map escape sequences back
|
|
# to keys. It is therefore required to update the terminfo when changing an
|
|
# escape sequence.
|
|
#
|
|
# - `action`: Execute a predefined action
|
|
#
|
|
# - Copy
|
|
# - Paste
|
|
# - PasteSelection
|
|
# - IncreaseFontSize
|
|
# - DecreaseFontSize
|
|
# - ResetFontSize
|
|
# - ScrollPageUp
|
|
# - ScrollPageDown
|
|
# - ScrollLineUp
|
|
# - ScrollLineDown
|
|
# - ScrollToTop
|
|
# - ScrollToBottom
|
|
# - ClearHistory
|
|
# - Hide
|
|
# - Minimize
|
|
# - Quit
|
|
# - ToggleFullscreen
|
|
# - SpawnNewInstance
|
|
# - ClearLogNotice
|
|
# - ReceiveChar
|
|
# - None
|
|
#
|
|
# (macOS only):
|
|
# - ToggleSimpleFullscreen: Enters fullscreen without occupying another space
|
|
#
|
|
# - `command`: Fork and execute a specified command plus arguments
|
|
#
|
|
# The `command` field must be a map containing a `program` string and an
|
|
# `args` array of command line parameter strings. For example:
|
|
# `{ program: "alacritty", args: ["-e", "vttest"] }`
|
|
#
|
|
# And optionally:
|
|
#
|
|
# - `mods`: Key modifiers to filter binding actions
|
|
#
|
|
# - Command
|
|
# - Control
|
|
# - Option
|
|
# - Super
|
|
# - Shift
|
|
# - Alt
|
|
#
|
|
# Multiple `mods` can be combined using `|` like this:
|
|
# `mods: Control|Shift`.
|
|
# Whitespace and capitalization are relevant and must match the example.
|
|
#
|
|
# - `mode`: Indicate a binding for only specific terminal reported modes
|
|
#
|
|
# This is mainly used to send applications the correct escape sequences
|
|
# when in different modes.
|
|
#
|
|
# - AppCursor
|
|
# - AppKeypad
|
|
# - Alt
|
|
#
|
|
# A `~` operator can be used before a mode to apply the binding whenever
|
|
# the mode is *not* active, e.g. `~Alt`.
|
|
#
|
|
# Bindings are always filled by default, but will be replaced when a new
|
|
# binding with the same triggers is defined. To unset a default binding, it can
|
|
# be mapped to the `ReceiveChar` action. Alternatively, you can use `None` for
|
|
# a no-op if you do not wish to receive input characters for that binding.
|
|
#key_bindings:
|
|
# (Windows, Linux, and BSD only)
|
|
#- { key: V, mods: Control|Shift, action: Paste }
|
|
#- { key: C, mods: Control|Shift, action: Copy }
|
|
#- { key: Insert, mods: Shift, action: PasteSelection }
|
|
#- { key: Key0, mods: Control, action: ResetFontSize }
|
|
#- { key: Equals, mods: Control, action: IncreaseFontSize }
|
|
#- { key: Add, mods: Control, action: IncreaseFontSize }
|
|
#- { key: Subtract, mods: Control, action: DecreaseFontSize }
|
|
#- { key: Minus, mods: Control, action: DecreaseFontSize }
|
|
|
|
# (Windows only)
|
|
#- { key: Return, mods: Alt, action: ToggleFullscreen }
|
|
|
|
# (macOS only)
|
|
#- { key: Key0, mods: Command, action: ResetFontSize }
|
|
#- { key: Equals, mods: Command, action: IncreaseFontSize }
|
|
#- { key: Add, mods: Command, action: IncreaseFontSize }
|
|
#- { key: Minus, mods: Command, action: DecreaseFontSize }
|
|
#- { key: K, mods: Command, action: ClearHistory }
|
|
#- { key: K, mods: Command, chars: "\x0c" }
|
|
#- { key: V, mods: Command, action: Paste }
|
|
#- { key: C, mods: Command, action: Copy }
|
|
#- { key: H, mods: Command, action: Hide }
|
|
#- { key: M, mods: Command, action: Minimize }
|
|
#- { key: Q, mods: Command, action: Quit }
|
|
#- { key: W, mods: Command, action: Quit }
|
|
#- { key: F, mods: Command|Control, action: ToggleFullscreen }
|
|
|
|
#- { key: Paste, action: Paste }
|
|
#- { key: Copy, action: Copy }
|
|
#- { key: L, mods: Control, action: ClearLogNotice }
|
|
#- { key: L, mods: Control, chars: "\x0c" }
|
|
#- { key: PageUp, mods: Shift, action: ScrollPageUp, mode: ~Alt }
|
|
#- { key: PageDown, mods: Shift, action: ScrollPageDown, mode: ~Alt }
|
|
#- { key: Home, mods: Shift, action: ScrollToTop, mode: ~Alt }
|
|
#- { key: End, mods: Shift, action: ScrollToBottom, mode: ~Alt }
|