Alan Orth
44f67af478
Remote hosts that don't have alacritty in their terminfo database show warnings when using programs like less. In one case I even had an Ubuntu 18.04 server fail to complete its updates because of some error related to locales caused by this.
548 lines
16 KiB
YAML
548 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.
|
|
# 2020-04-01: avoid errors on remote systems when using less etc.
|
|
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 only):
|
|
#class:
|
|
# Application instance name
|
|
#instance: Alacritty
|
|
# General application class
|
|
#general: Alacritty
|
|
|
|
# GTK theme variant (Linux 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
|
|
|
|
# Scroll to the bottom when new text is written to the terminal.
|
|
#auto_scroll: false
|
|
|
|
# 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) monospace
|
|
# - (Windows) Consolas
|
|
family: Fira Mono
|
|
|
|
# The `style` can be specified to pick a specific face.
|
|
style: Medium
|
|
|
|
# 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: Fira Mono
|
|
|
|
# The `style` can be specified to pick a specific face.
|
|
style: Medium
|
|
|
|
# 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: Fira Mono
|
|
|
|
# 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: Fira Mono
|
|
|
|
# The `style` can be specified to pick a specific face.
|
|
style: Medium 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 (Solarized Dark)
|
|
colors:
|
|
# Default colors
|
|
primary:
|
|
background: '0x002b36' # base03
|
|
foreground: '0x839496' # base0
|
|
|
|
# Cursor colors
|
|
cursor:
|
|
text: '0x002b36' # base03
|
|
cursor: '0x839496' # base0
|
|
|
|
# Normal colors
|
|
normal:
|
|
black: '0x073642' # base02
|
|
red: '0xdc322f' # red
|
|
green: '0x859900' # green
|
|
yellow: '0xb58900' # yellow
|
|
blue: '0x268bd2' # blue
|
|
magenta: '0xd33682' # magenta
|
|
cyan: '0x2aa198' # cyan
|
|
white: '0xeee8d5' # base2
|
|
|
|
# Bright colors
|
|
bright:
|
|
black: '0x002b36' # base03
|
|
red: '0xcb4b16' # orange
|
|
green: '0x586e75' # base01
|
|
yellow: '0x657b83' # base00
|
|
blue: '0x839496' # base0
|
|
magenta: '0x6c71c4' # violet
|
|
cyan: '0x93a1a1' # base1
|
|
white: '0xfdf6e3' # base3
|
|
|
|
# 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) 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
|
|
|
|
# Windows 10 ConPTY backend (Windows only)
|
|
#
|
|
# This will enable better color support and may resolve other issues,
|
|
# however this API and its implementation is still young and so is
|
|
# disabled by default, as stability may not be as good as the winpty
|
|
# backend.
|
|
#
|
|
# Alacritty will fall back to the WinPTY automatically if the ConPTY
|
|
# backend cannot be initialized.
|
|
#enable_experimental_conpty_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) 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.
|
|
#
|
|
# 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
|
|
# - 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 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 }
|
|
#- { 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: 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 }
|