1 # Configuration for Alacritty, the GPU enhanced terminal emulator.
3 # Any items in the `env` entry below will be added as
4 # environment variables. Some entries may override variables
5 # set by alacritty itself.
9 # This value is used to set the `$TERM` environment variable for
10 # each instance of Alacritty. If it is not present, alacritty will
11 # check the local terminfo database and use `alacritty` if it is
12 # available, otherwise `xterm-256color` is used.
16 # Window dimensions (changes require restart)
18 # Specified in number of columns/lines, not pixels.
19 # If both are `0`, this setting is ignored.
24 # Window position (changes require restart)
26 # Specified in number of pixels.
27 # If the position is not set, the window manager will handle the placement.
32 # Window padding (changes require restart)
34 # Blank space added around the window in pixels. This padding is scaled
35 # by DPI and the specified value is always added at both opposing sides.
40 # Spread additional padding evenly around the terminal content.
41 #dynamic_padding: false
45 # Values for `decorations`:
46 # - full: Borders and title bar
47 # - none: Neither borders nor title bar
49 # Values for `decorations` (macOS only):
50 # - transparent: Title bar, transparent background and title bar buttons
51 # - buttonless: Title bar, transparent background, but no title bar buttons
54 # Startup Mode (changes require restart)
56 # Values for `startup_mode`:
61 # Values for `startup_mode` (macOS only):
63 #startup_mode: Windowed
68 # Window class (Linux/BSD only):
70 # Application instance name
72 # General application class
75 # GTK theme variant (Linux/BSD only)
77 # Override the variant of the GTK theme. Commonly supported values are `dark` and `light`.
78 # Set this to `None` to use the default theme variant.
79 #gtk_theme_variant: None
82 # Maximum number of lines in the scrollback buffer.
83 # Specifying '0' will disable scrolling.
86 # Number of lines the viewport will move for every line scrolled when
87 # scrollback is enabled (history > 0).
92 # Normal (roman) font face
98 # - (Linux/BSD) monospace
99 # - (Windows) Consolas
102 # The `style` can be specified to pick a specific face.
109 # If the bold family is not specified, it will fall back to the
110 # value specified for the normal font.
113 # The `style` can be specified to pick a specific face.
120 # If the italic family is not specified, it will fall back to the
121 # value specified for the normal font.
124 # The `style` can be specified to pick a specific face.
127 # Bold italic font face
131 # If the bold italic family is not specified, it will fall back to the
132 # value specified for the normal font.
135 # The `style` can be specified to pick a specific face.
141 # Offset is the extra space around each character. `offset.y` can be thought of
142 # as modifying the line spacing, and `offset.x` as modifying the letter spacing.
147 # Glyph offset determines the locations of the glyphs within their cells with
148 # the default being at the bottom. Increasing `x` moves the glyph to the right,
149 # increasing `y` moves the glyph upwards.
154 # Thin stroke font rendering (macOS only)
156 # Thin strokes are suitable for retina displays, but for non-retina screens
157 # it is recommended to set `use_thin_strokes` to `false`
161 # If the font quality on non-retina display looks bad then set
162 # `use_thin_strokes` to `true` and enable font smoothing by running the
164 # `defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO`
166 # This is a global setting and will require a log out or restart to take
168 #use_thin_strokes: true
170 # If `true`, bold text is drawn using the bright color variants.
171 #draw_bold_text_with_bright_colors: false
173 # Colors (Tomorrow Night Bright)
177 # background: '#000000'
178 # foreground: '#eaeaea'
180 # Bright and dim foreground colors
182 # The dimmed foreground color is calculated automatically if it is not present.
183 # If the bright foreground color is not set, or `draw_bold_text_with_bright_colors`
184 # is `false`, the normal foreground color will be used.
185 #dim_foreground: '#9a9a9a'
186 #bright_foreground: '#ffffff'
190 # Colors which should be used to draw the terminal cursor. If these are
191 # unset, the cursor color will be the inverse of the cell color.
196 # Vi mode cursor colors
198 # Colors for the cursor when the vi mode is active. If these are unset, the
199 # cursor color will be the inverse of the cell color.
206 # Colors which should be used to draw the selection area. If selection
207 # background is unset, selection color will be the inverse of the cell colors.
208 # If only text is unset the cell text color will remain the same.
211 # background: '#404040'
237 # If the dim colors are not set, they will be calculated automatically based
238 # on the `normal` colors.
251 # The indexed colors include all colors from 16 to 256.
252 # When these are not set, they're filled with sensible defaults.
255 # `- { index: 16, color: '#ff00ff' }`
261 # Any time the BEL code is received, Alacritty "rings" the visual bell. Once
262 # rung, the terminal background will be set to white and transition back to the
263 # default background color. You can control the rate of this transition by
264 # setting the `duration` property (represented in milliseconds). You can also
265 # configure the transition function by setting the `animation` property.
267 # Values for `animation`:
279 # Specifying a `duration` of `0` will disable the visual bell.
281 # animation: EaseOutExpo
287 # Window opacity as a floating point number from `0.0` to `1.0`.
288 # The value `0.0` is completely transparent and `1.0` is opaque.
289 background_opacity: 0.85
292 #semantic_escape_chars: ",│`|:\"' ()[]{}<>\t"
294 # When set to `true`, selected text will be copied to the primary clipboard.
295 #save_to_clipboard: false
297 # Allow terminal applications to change Alacritty's window title.
303 # Values for `style`:
309 # Vi mode cursor style
311 # If the vi mode cursor style is `None` or not specified, it will fall back to
312 # the style of the active value of the normal cursor.
314 # See `cursor.style` for available options.
317 # If this is `true`, the cursor will be rendered as a hollow box when the
318 # window is not focused.
319 unfocused_hollow: true
321 # Live config reload (changes require restart)
322 #live_config_reload: true
326 # You can set `shell.program` to the path of your favorite shell, e.g. `/bin/fish`.
327 # Entries in `shell.args` are passed unmodified as arguments to the shell.
330 # - (macOS) /bin/bash --login
331 # - (Linux/BSD) user login shell
332 # - (Windows) powershell
340 # Directory the shell is started in. If this is unset, or `None`, the working
341 # directory of the parent process will be used.
342 #working_directory: None
344 # WinPTY backend (Windows only)
346 # Alacritty defaults to using the newer ConPTY backend if it is available,
347 # since it resolves a lot of bugs and is quite a bit faster. If it is not
348 # available, the the WinPTY backend will be used instead.
350 # Setting this option to `true` makes Alacritty use the legacy WinPTY backend,
351 # even if the ConPTY backend is available.
352 #winpty_backend: false
354 # Send ESC (\x1b) before characters when alt is pressed.
360 # The `double_click` and `triple_click` settings control the time
361 # alacritty should wait for accepting multiple clicks as one double
363 #double_click: { threshold: 300 }
364 #triple_click: { threshold: 300 }
366 # If this is `true`, the cursor is temporarily hidden when typing.
367 #hide_when_typing: false
372 # This program is executed when clicking on a text which is recognized as a URL.
373 # The URL is always added to the command as the last parameter.
375 # When set to `None`, URL launching will be disabled completely.
379 # - (Linux/BSD) xdg-open
380 # - (Windows) explorer
387 # These are the modifiers that need to be held down for opening URLs when clicking
388 # on them. The available modifiers are documented in the key binding section.
393 # Mouse bindings are specified as a list of objects, much like the key
394 # bindings further below.
396 # To trigger mouse bindings when an application running within Alacritty captures the mouse, the
397 # `Shift` modifier is automatically added as a requirement.
399 # Each mouse binding will specify a:
406 # - Numeric identifier such as `5`
408 # - `action` (see key bindings)
412 # - `mods` (see key bindings)
414 # - { mouse: Middle, action: PasteSelection }
418 # Key bindings are specified as a list of objects. For example, this is the
419 # default paste binding:
421 # `- { key: V, mods: Control|Shift, action: Paste }`
423 # Each key binding will specify a:
425 # - `key`: Identifier of the key pressed
431 # A full list with available key codes can be found here:
432 # https://docs.rs/glutin/*/glutin/event/enum.VirtualKeyCode.html#variants
434 # Instead of using the name of the keys, the `key` field also supports using
435 # the scancode of the desired key. Scancodes have to be specified as a
436 # decimal number. This command will allow you to display the hex scancodes
439 # `showkey --scancodes`.
441 # Then exactly one of:
443 # - `chars`: Send a byte sequence to the running application
445 # The `chars` field writes the specified string to the terminal. This makes
446 # it possible to pass escape sequences. To find escape codes for bindings
447 # like `PageUp` (`"\x1b[5~"`), you can run the command `showkey -a` outside
448 # of tmux. Note that applications use terminfo to map escape sequences back
449 # to keys. It is therefore required to update the terminfo when changing an
452 # - `action`: Execute a predefined action
499 # - ToggleNormalSelection
500 # - ToggleLineSelection
501 # - ToggleBlockSelection
502 # - ToggleSemanticSelection
505 # - ToggleSimpleFullscreen: Enters fullscreen without occupying another space
508 # - CopySelection: Copies into selection buffer
510 # - `command`: Fork and execute a specified command plus arguments
512 # The `command` field must be a map containing a `program` string and an
513 # `args` array of command line parameter strings. For example:
514 # `{ program: "alacritty", args: ["-e", "vttest"] }`
518 # - `mods`: Key modifiers to filter binding actions
527 # Multiple `mods` can be combined using `|` like this:
528 # `mods: Control|Shift`.
529 # Whitespace and capitalization are relevant and must match the example.
531 # - `mode`: Indicate a binding for only specific terminal reported modes
533 # This is mainly used to send applications the correct escape sequences
534 # when in different modes.
540 # A `~` operator can be used before a mode to apply the binding whenever
541 # the mode is *not* active, e.g. `~Alt`.
543 # Bindings are always filled by default, but will be replaced when a new
544 # binding with the same triggers is defined. To unset a default binding, it can
545 # be mapped to the `ReceiveChar` action. Alternatively, you can use `None` for
546 # a no-op if you do not wish to receive input characters for that binding.
548 # If the same trigger is assigned to multiple actions, all of them are executed
551 #- { key: Paste, action: Paste }
552 #- { key: Copy, action: Copy }
553 #- { key: L, mods: Control, action: ClearLogNotice }
554 #- { key: L, mods: Control, mode: ~Vi, chars: "\x0c" }
555 #- { key: PageUp, mods: Shift, mode: ~Alt, action: ScrollPageUp, }
556 #- { key: PageDown, mods: Shift, mode: ~Alt, action: ScrollPageDown }
557 #- { key: Home, mods: Shift, mode: ~Alt, action: ScrollToTop, }
558 #- { key: End, mods: Shift, mode: ~Alt, action: ScrollToBottom }
561 #- { key: Space, mods: Shift|Control, mode: Vi, action: ScrollToBottom }
562 #- { key: Space, mods: Shift|Control, action: ToggleViMode }
563 #- { key: Escape, mode: Vi, action: ClearSelection }
564 #- { key: I, mode: Vi, action: ScrollToBottom }
565 #- { key: I, mode: Vi, action: ToggleViMode }
566 #- { key: Y, mods: Control, mode: Vi, action: ScrollLineUp }
567 #- { key: E, mods: Control, mode: Vi, action: ScrollLineDown }
568 #- { key: G, mode: Vi, action: ScrollToTop }
569 #- { key: G, mods: Shift, mode: Vi, action: ScrollToBottom }
570 #- { key: B, mods: Control, mode: Vi, action: ScrollPageUp }
571 #- { key: F, mods: Control, mode: Vi, action: ScrollPageDown }
572 #- { key: U, mods: Control, mode: Vi, action: ScrollHalfPageUp }
573 #- { key: D, mods: Control, mode: Vi, action: ScrollHalfPageDown }
574 #- { key: Y, mode: Vi, action: Copy }
575 #- { key: Y, mode: Vi, action: ClearSelection }
576 #- { key: Copy, mode: Vi, action: ClearSelection }
577 #- { key: V, mode: Vi, action: ToggleNormalSelection }
578 #- { key: V, mods: Shift, mode: Vi, action: ToggleLineSelection }
579 #- { key: V, mods: Control, mode: Vi, action: ToggleBlockSelection }
580 #- { key: V, mods: Alt, mode: Vi, action: ToggleSemanticSelection }
581 #- { key: Return, mode: Vi, action: Open }
582 #- { key: K, mode: Vi, action: Up }
583 #- { key: J, mode: Vi, action: Down }
584 #- { key: H, mode: Vi, action: Left }
585 #- { key: L, mode: Vi, action: Right }
586 #- { key: Up, mode: Vi, action: Up }
587 #- { key: Down, mode: Vi, action: Down }
588 #- { key: Left, mode: Vi, action: Left }
589 #- { key: Right, mode: Vi, action: Right }
590 #- { key: Key0, mode: Vi, action: First }
591 #- { key: Key4, mods: Shift, mode: Vi, action: Last }
592 #- { key: Key6, mods: Shift, mode: Vi, action: FirstOccupied }
593 #- { key: H, mods: Shift, mode: Vi, action: High }
594 #- { key: M, mods: Shift, mode: Vi, action: Middle }
595 #- { key: L, mods: Shift, mode: Vi, action: Low }
596 #- { key: B, mode: Vi, action: SemanticLeft }
597 #- { key: W, mode: Vi, action: SemanticRight }
598 #- { key: E, mode: Vi, action: SemanticRightEnd }
599 #- { key: B, mods: Shift, mode: Vi, action: WordLeft }
600 #- { key: W, mods: Shift, mode: Vi, action: WordRight }
601 #- { key: E, mods: Shift, mode: Vi, action: WordRightEnd }
602 #- { key: Key5, mods: Shift, mode: Vi, action: Bracket }
604 # (Windows, Linux, and BSD only)
605 #- { key: V, mods: Control|Shift, action: Paste }
606 #- { key: C, mods: Control|Shift, action: Copy }
607 #- { key: C, mods: Control|Shift, mode: Vi, action: ClearSelection }
608 #- { key: Insert, mods: Shift, action: PasteSelection }
609 #- { key: Key0, mods: Control, action: ResetFontSize }
610 #- { key: Equals, mods: Control, action: IncreaseFontSize }
611 #- { key: Add, mods: Control, action: IncreaseFontSize }
612 #- { key: Subtract, mods: Control, action: DecreaseFontSize }
613 #- { key: Minus, mods: Control, action: DecreaseFontSize }
616 #- { key: Return, mods: Alt, action: ToggleFullscreen }
619 #- { key: K, mods: Command, mode: ~Vi, chars: "\x0c" }
620 #- { key: Key0, mods: Command, action: ResetFontSize }
621 #- { key: Equals, mods: Command, action: IncreaseFontSize }
622 #- { key: Add, mods: Command, action: IncreaseFontSize }
623 #- { key: Minus, mods: Command, action: DecreaseFontSize }
624 #- { key: K, mods: Command, action: ClearHistory }
625 #- { key: V, mods: Command, action: Paste }
626 #- { key: C, mods: Command, action: Copy }
627 #- { key: C, mods: Command, mode: Vi, action: ClearSelection }
628 #- { key: H, mods: Command, action: Hide }
629 #- { key: M, mods: Command, action: Minimize }
630 #- { key: Q, mods: Command, action: Quit }
631 #- { key: W, mods: Command, action: Quit }
632 #- { key: N, mods: Command, action: SpawnNewInstance }
633 #- { key: F, mods: Command|Control, action: ToggleFullscreen }
636 # Display the time it takes to redraw each frame.
639 # Keep the log file after quitting Alacritty.
640 #persistent_logging: false
644 # Values for `log_level`:
653 # Print all received window events.
655 #Font configuration (changes require restart)
657 family: DejaVu Sans Mono