# 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 TERM: alacritty # COLORTERM: truecolor window: # Window dimensions (changes require restart) # # Specified in number of columns/lines, not pixels. # If both are `0`, this setting is ignored. dimensions: columns: 80 lines: 24 # 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 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: true # 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 (changes require restart) # # Important font attributes like antialiasing, subpixel aa, and hinting can be # controlled through fontconfig. Specifically, the following attributes should # have an effect: # - hintstyle # - antialias # - lcdfilter # - rgba # # For instance, if you wish to disable subpixel antialiasing, you might set the # rgba property to `none`. If you wish to completely disable antialiasing, you # can set antialias to `false`. # # Please see these resources for more information on how to use fontconfig: # - https://wiki.archlinux.org/index.php/font_configuration#Fontconfig_configuration # - file:///usr/share/doc/fontconfig/fontconfig-user.html font: # Normal (roman) font face normal: family: Iosevka # The `style` can be specified to pick a specific face. style: Slim # Bold font face bold: style: Bold # Italic font face italic: style: Italic bold_italic: style: Bold Italic # Point size size: 13.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 (Papercolor) colors: # Default colors primary: background: &bg '#1c1c1c' foreground: &fg '#d0d0d0' # 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: '#BDC0BA' # bright_foreground: '#ffffff' # just white ;) # 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: *bg cursor: *fg # 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: '#251c16' background: '#fffffc' # Normal colors normal: black: '#1c1c1c' red: '#af005f' green: '#5faf00' yellow: '#d7af5f' blue: '#5fafd7' magenta: '#808080' cyan: '#d7875f' white: '#d0d0d0' # Bright colors bright: black: '#585858' red: '#5faf5f' green: '#afd700' yellow: '#af87d7' blue: '#ffaf00' magenta: '#00afaf' cyan: '#5f8787' white: '#fffffc' # 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: '0x000000' } 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: duration: 0 color: '#af005f' # bell_command: { program: "mpv", args: ["--no-config", "--no-idle", "/usr/share/sounds/gnome/default/alerts/glass.ogg"] } # 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: 0.99 selection: semantic_escape_chars: ",│`|:\"' ()[]{}<>" # When set to `true`, selected text will be copied to both the primary and # the selection clipboard. Otherwise, it will only be copied to the selection # clipboard. save_to_clipboard: false 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: true 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: url-launcher 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: Control # 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: - { key: V, mods: Super, action: Paste } - { key: C, mods: Super, 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 } - { key: W, mods: Super|Shift, action: Quit } - { key: N, mods: Super|Shift, action: SpawnNewInstance } - { key: Paste, action: Paste } - { key: Copy, action: Copy } - { key: L, mods: Control, action: ClearLogNotice } - { key: L, mods: Control, chars: "\x0c" } - { key: PageUp, mods: Alt, action: ScrollPageUp } - { key: PageDown, mods: Alt, action: ScrollPageDown }