# Configuration for Alacritty, the GPU enhanced terminal emulator. # Import additional configuration files # # These configuration files will be loaded in order, replacing values in files # loaded earlier with those loaded later in the chain. The file itself will # always be loaded last. #import: # - /path/to/alacritty.yml # 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: alacritty window: # Window dimensions (changes require restart) # # Number of lines/columns (not pixels) in the terminal. The number of columns # must be at least `2`, while using a value of `0` for columns and lines will # fall back to the window manager's recommended size. #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 # Window title #title: Alacritty # Allow terminal applications to change Alacritty's window title. dynamic_title: true # 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: 100000 # Scrolling distance multiplier. #multiplier: 3 # Font configuration font: normal: family: monospace style: Regular #bold: #family: monospace #style: Bold italic: family: monospace style: Italic bold_italic: family: monospace 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 upward. glyph_offset: x: 0 y: 0 # If `true`, bold text is drawn using the bright color variants. draw_bold_text_with_bright_colors: false schemes: default_base: &light # Default colors primary: background: '0xefece4' foreground: '0x484245' # Colors the cursor will use if `custom_cursor_colors` is true cursor: text: '0xefecf4' cursor: '0x585260' # Normal colors normal: black: '0xefecf4' red: '0xbe4638' green: '0x2a9292' yellow: '0xa06e3b' blue: '0x576ddb' magenta: '0x955ae7' cyan: '0x398bc6' white: '0x585260' # Bright colors bright: black: '0x7e7887' red: '0xbe3648' green: '0x2a9292' yellow: '0xa06e3b' blue: '0x576ddb' magenta: '0x955ae7' cyan: '0x398bc6' white: '0x19171c' indexed_colors: - { index: 16, color: '0xaa573c' } - { index: 17, color: '0xbf40bf' } - { index: 18, color: '0xe2dfe7' } - { index: 19, color: '0x8b8792' } - { index: 20, color: '0x655f6d' } - { index: 21, color: '0x26232a' } alt_light: &alt_light primary: background: '0xf8f8f8' foreground: '0x383838' # Colors the cursor will use if `custom_cursor_colors` is true cursor: text: '0xf8f8f8' cursor: '0x383838' # Normal colors normal: black: '0xf8f8f8' red: '0xab4642' green: '0x538947' yellow: '0xf79a0e' blue: '0x7cafc2' magenta: '0x96609e' cyan: '0x4b8093' white: '0x383838' # Bright colors bright: black: '0xb8b8b8' red: '0xab4642' green: '0x538947' yellow: '0xf79a0e' blue: '0x7cafc2' magenta: '0x96609e' cyan: '0x4b8093' white: '0x181818' indexed_colors: - { index: 16, color: '0xdc9656' } - { index: 17, color: '0xa16946' } - { index: 18, color: '0xe8e8e8' } - { index: 19, color: '0xd8d8d8' } - { index: 20, color: '0x585858' } - { index: 21, color: '0x282828' } tomorrow: &tomorrow # Default colors primary: background: '0xffffff' foreground: '0x242424' # Colors the cursor will use if `custom_cursor_colors` is true cursor: text: '0xffffff' cursor: '0x242424' # Normal colors normal: black: '0xffffff' red: '0xc82829' green: '0x718c00' yellow: '0xf79a0e' blue: '0x4271ae' magenta: '0x8959a8' cyan: '0x3e999f' white: '0x242424' # Bright colors bright: black: '0x8e908c' red: '0xc82829' green: '0x718c00' yellow: '0xf79a0e' blue: '0x4271ae' magenta: '0x8959a8' cyan: '0x3e999f' white: '0x1d1f21' indexed_colors: - { index: 16, color: '0xf5871f' } - { index: 17, color: '0xa3685a' } - { index: 18, color: '0xe0e0e0' } - { index: 19, color: '0xd6d6d6' } - { index: 20, color: '0x969896' } - { index: 21, color: '0x282a2e' } # Colors (Tomorrow Night) tomorrow_night: &tomorrow_night # Default colors primary: background: '#171717' foreground: '#c5c8c6' # 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: '#828482' bright_foreground: '#eaeaea' # Cursor colors # # Colors which should be used to draw the terminal cursor. # # Allowed values are CellForeground and CellBackground, which reference the # affected cell, or hexadecimal colors like #ff00ff. cursor: text: CellBackground cursor: CellForeground # Vi mode cursor colors # # Colors for the cursor when the vi mode is active. # # Allowed values are CellForeground and CellBackground, which reference the # affected cell, or hexadecimal colors like #ff00ff. vi_mode_cursor: text: CellBackground cursor: CellForeground # Selection colors # # Colors which should be used to draw the selection area. # # Allowed values are CellForeground and CellBackground, which reference the # affected cell, or hexadecimal colors like #ff00ff. selection: text: CellBackground background: CellForeground # Search colors # # Colors used for the search bar and match highlighting. search: # Allowed values are CellForeground and CellBackground, which reference the # affected cell, or hexadecimal colors like #ff00ff. matches: foreground: '#000000' background: '#ddee00' bar: background: '#c5c8c6' foreground: '#1d1f21' # Normal colors normal: black: '#1d1f21' red: '#cc6666' green: '#b5bd68' yellow: '#f0c674' blue: '#81a2be' magenta: '#b294bb' cyan: '#8abeb7' white: '#c5c8c6' # Bright colors bright: black: '#666666' red: '#d54e53' green: '#b9ca4a' yellow: '#e7c547' blue: '#7aa6da' magenta: '#c397d8' cyan: '#70c0b1' white: '#eaeaea' # Dim colors # # If the dim colors are not set, they will be calculated automatically based # on the `normal` colors. dim: black: '#131415' red: '#864343' green: '#777c44' yellow: '#9e824c' blue: '#556a7d' magenta: '#75617b' cyan: '#5b7d78' white: '#828482' colors: *tomorrow # Bell # # The bell is rung every time the BEL control character is received. #bell: # Visual Bell Animation # # Animation effect for flashing the screen when the visual bell is rung. # # Values for `animation`: # - Ease # - EaseOut # - EaseOutSine # - EaseOutQuad # - EaseOutCubic # - EaseOutQuart # - EaseOutQuint # - EaseOutExpo # - EaseOutCirc # - Linear #animation: EaseOutExpo # Duration of the visual bell flash. A `duration` of `0` will disable the # visual bell animation. #duration: 0 # Visual bell animation color. #color: '#ffffff' # Bell Command # # This program is executed whenever the bell is rung. # # When set to `command: None`, no command will be executed. # # Example: # command: # program: notify-send # args: ["Hello, World!"] # #command: None # 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: # This string contains all characters that are used as separators for "semantic words" in Alacritty. semantic_escape_chars: ",│`|:\"' ()[]{}<>\t" # When set to `true`, selected text will be copied to the primary clipboard. save_to_clipboard: true cursor: # Cursor style # # Values for `style`: # - ▇ Block # - _ Underline # - | Beam style: Beam #style: # # Cursor shape # # # # Values for `shape`: # # - ▇ Block # # - _ Underline # # - | Beam # shape: Beam # # Cursor blinking state # # # # Values for `blinking`: # # - Never: Prevent the cursor from ever blinking # # - Off: Disable blinking by default # # - On: Enable blinking by default # # - Always: Force the cursor to always blink # blinking: On # Vi mode cursor style # # If the vi mode cursor style is `None` or not specified, it will fall back to # the style of the active value of the normal cursor. # # See `cursor.style` for available options. vi_mode_style: Block # If this is `true`, the cursor will be rendered as a hollow box when the # window is not focused. unfocused_hollow: true # Thickness of the cursor relative to the cell width as floating point number # from `0.0` to `1.0`. thickness: 0.2 # 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 # Send ESC (\x1b) before characters when alt is pressed. #alt_send_esc: true 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 # Regex hints # # Terminal hints can be used to find text in the visible part of the terminal # and pipe it to other applications. hints: # Keys used for the hint labels. #alphabet: "jfkdls;ahgurieowpq" # List with all available hints # # Each hint must have a `regex` and either an `action` or a `command` field. # The fields `mouse`, `binding` and `post_processing` are optional. # # The fields `command`, `binding.key`, `binding.mods` and `mouse.mods` accept # the same values as they do in the `key_bindings` section. # # The `mouse.enabled` field controls if the hint should be underlined while # the mouse with all `mouse.mods` keys held or the vi mode cursor is above it. # # If the `post_processing` field is set to `true`, heuristics will be used to # shorten the match if there are characters likely not to be part of the hint # (e.g. a trailing `.`). This is most useful for URIs. # # Values for `action`: # - Copy # Copy the hint's text to the clipboard. # - Paste # Paste the hint's text to the terminal or search. # - Select # Select the hint's text. # - MoveViModeCursor # Move the vi mode cursor to the beginning of the hint. enabled: - regex: "(ipfs:|ipns:|magnet:|mailto:|gemini:|gopher:|https:|http:|news:|file:|git:|ssh:|ftp:)\ [^\u0000-\u001F\u007F-\u009F<>\"\\s{-}\\^⟨⟩`]+" command: xdg-open post_processing: true mouse: enabled: true mods: 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 # # - ToggleViMode # - SearchForward # Start searching toward the right of the search origin. # - SearchBackward # Start searching toward the left of the search origin. # - Copy # - Paste # - IncreaseFontSize # - DecreaseFontSize # - ResetFontSize # - ScrollPageUp # - ScrollPageDown # - ScrollHalfPageUp # - ScrollHalfPageDown # - ScrollLineUp # - ScrollLineDown # - ScrollToTop # - ScrollToBottom # - ClearHistory # Remove the terminal's scrollback history. # - Hide # Hide the Alacritty window. # - Minimize # Minimize the Alacritty window. # - Quit # Quit Alacritty. # - ToggleFullscreen # - SpawnNewInstance # Spawn a new instance of Alacritty. # - ClearLogNotice # Clear Alacritty's UI warning and error notice. # - ClearSelection # Remove the active selection. # - ReceiveChar # - None # # (`mode: Vi` only): # - Open # Open URLs at the cursor location with the launcher configured in `url.launcher`. # - Up # Move the vi mode cursor up by one line. # - Down # Move the vi mode cursor down by one line. # - Left # Move the vi mode cursor left by one character. # - Right # Move the vi mode cursor right by one character. # - First # Move the vi mode cursor to the start of the line, searching across newlines if it is already at the beginning. # - Last # Move the vi mode cursor to the end of the line, searching across newlines if it is already at the end. # - FirstOccupied # Move the vi mode cursor to the first non-empty cell in this line, searching across newlines if it is already at the first one. # - High # Move the vi mode cursor to the top of the screen. # - Middle # Move the vi mode cursor to the middle of the screen. # - Low # Move the vi mode cursor to the bottom of the screen. # - SemanticLeft # Move the vi mode cursor to the start of the previous semantically separated word. # - SemanticRight # Move the vi mode cursor to the start of the next semantically separated word. # - SemanticLeftEnd # Move the vi mode cursor to the end of the previous semantically separated word. # - SemanticRightEnd # Move the vi mode cursor to the end of the next semantically separated word. # - WordLeft # Move the vi mode cursor to the start of the previous whitespace separated word. # - WordRight # Move the vi mode cursor to the start of the next whitespace separated word. # - WordLeftEnd # Move the vi mode cursor to the end of the previous whitespace separated word. # - WordRightEnd # Move the vi mode cursor to the end of the next whitespace separated word. # - Bracket # Move the vi mode cursor to the next character that matches the bracket at the cursor's # current location. # - ToggleNormalSelection # - ToggleLineSelection # - ToggleBlockSelection # - ToggleSemanticSelection # Toggle semantic selection based on `selection.semantic_escape_chars`. # - SearchNext # Jump to the beginning of the next match. # - SearchPrevious # Jump to the beginning of the previous match. # - SearchStart # Jump to the next start of a match to the left of the vi mode cursor. # - SearchEnd # Jump to the next end of a match to the left of the vi mode cursor. # # (macOS only): # - ToggleSimpleFullscreen # Enter fullscreen without occupying another space. # # (Linux/BSD only): # - CopySelection # Copy from the selection buffer. # - PasteSelection # Paste from the selection buffer. # # - `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 # - Vi # # 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. # # If the same trigger is assigned to multiple actions, all of them are executed # in the order they were defined in. key_bindings: - { key: Paste, action: Paste } - { key: Copy, action: Copy } - { key: L, mods: Control, action: ClearLogNotice } - { key: L, mods: Control, mode: ~Vi, chars: "\x0c" } - { key: PageUp, mods: Shift, mode: ~Alt, action: ScrollPageUp, } - { key: PageDown, mods: Shift, mode: ~Alt, action: ScrollPageDown } - { key: Home, mods: Shift, mode: ~Alt, action: ScrollToTop, } - { key: End, mods: Shift, mode: ~Alt, action: ScrollToBottom } # Vi Mode - { key: Space, mods: Shift|Control, mode: Vi, action: ScrollToBottom } - { key: S, mods: Alt, action: ToggleViMode } - { key: Escape, mode: Vi, action: ClearSelection } - { key: I, mode: Vi, action: ScrollToBottom } - { key: I, mode: Vi, action: ToggleViMode } - { key: C, mods: Control, mode: Vi, action: ToggleViMode } - { key: Y, mods: Control, mode: Vi, action: ScrollLineUp } - { key: E, mods: Control, mode: Vi, action: ScrollLineDown } - { key: G, mode: Vi, action: ScrollToTop } - { key: G, mods: Shift, mode: Vi, action: ScrollToBottom } - { key: B, mods: Control, mode: Vi, action: ScrollPageUp } - { key: F, mods: Control, mode: Vi, action: ScrollPageDown } - { key: U, mods: Control, mode: Vi, action: ScrollHalfPageUp } - { key: D, mods: Control, mode: Vi, action: ScrollHalfPageDown } - { key: Y, mode: Vi, action: Copy } - { key: Y, mode: Vi, action: ClearSelection } - { key: Copy, mode: Vi, action: ClearSelection } - { key: V, mode: Vi, action: ToggleNormalSelection } - { key: V, mods: Shift, mode: Vi, action: ToggleLineSelection } - { key: V, mods: Control, mode: Vi, action: ToggleBlockSelection } - { key: V, mods: Alt, mode: Vi, action: ToggleSemanticSelection } - { key: Return, mode: Vi, action: Open } - { key: K, mode: Vi, action: Up } - { key: J, mode: Vi, action: Down } - { key: H, mode: Vi, action: Left } - { key: L, mode: Vi, action: Right } - { key: Up, mode: Vi, action: Up } - { key: Down, mode: Vi, action: Down } - { key: Left, mode: Vi, action: Left } - { key: Right, mode: Vi, action: Right } - { key: Key0, mode: Vi, action: First } - { key: Key4, mods: Shift, mode: Vi, action: Last } - { key: Key6, mods: Shift, mode: Vi, action: FirstOccupied } - { key: H, mods: Shift, mode: Vi, action: High } - { key: M, mods: Shift, mode: Vi, action: Middle } - { key: L, mods: Shift, mode: Vi, action: Low } - { key: B, mode: Vi, action: SemanticLeft } - { key: W, mode: Vi, action: SemanticRight } - { key: E, mode: Vi, action: SemanticRightEnd } - { key: B, mods: Shift, mode: Vi, action: WordLeft } - { key: W, mods: Shift, mode: Vi, action: WordRight } - { key: E, mods: Shift, mode: Vi, action: WordRightEnd } - { key: Key5, mods: Shift, mode: Vi, action: Bracket } - { key: Slash, mode: Vi, action: SearchForward } - { key: Slash, mods: Shift, mode: Vi, action: SearchBackward } - { key: N, mode: Vi, action: SearchNext } - { key: N, mods: Shift, mode: Vi, action: SearchPrevious } # (Windows, Linux, and BSD only) - { key: V, mods: Control|Shift, action: Paste } - { key: C, mods: Control|Shift, action: Copy } - { key: F, mods: Control|Shift, action: SearchForward } - { key: B, mods: Control|Shift, action: SearchBackward } - { key: C, mods: Control|Shift, mode: Vi, action: ClearSelection } - { key: Insert, mods: Shift, action: PasteSelection } - { key: Key0, mods: Control, action: ResetFontSize } - { key: Equals, mods: Control, action: IncreaseFontSize } - { key: Plus, mods: Control, action: IncreaseFontSize } - { key: Minus, mods: Control, action: DecreaseFontSize } #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