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 padding (changes require restart)
26 # Blank space added around the window in pixels. This padding is scaled
27 # by DPI and the specified value is always added at both opposing sides.
32 # Spread additional padding evenly around the terminal content.
33 dynamic_padding: false
37 # Values for `decorations`:
38 # - full: Borders and title bar
39 # - none: Neither borders nor title bar
41 # Values for `decorations` (macOS only):
42 # - transparent: Title bar, transparent background and title bar buttons
43 # - buttonless: Title bar, transparent background, but no title bar buttons
46 # When true, alacritty starts maximized.
47 start_maximized: false
50 # Maximum number of lines in the scrollback buffer.
51 # Specifying '0' will disable scrolling.
54 # Number of lines the viewport will move for every line scrolled when
55 # scrollback is enabled (history > 0).
60 # The `faux_multiplier` setting controls the number of lines the terminal
61 # should scroll when the alternate screen buffer is active. This is used
62 # to allow mouse scrolling for applications like `man`.
64 # Specifying `0` will disable faux scrolling.
67 # Scroll to the bottom when new text is written to the terminal.
70 # Spaces per Tab (changes require restart)
72 # This setting defines the width of a tab in cells.
74 # Some applications, like Emacs, rely on knowing about the width of a tab.
75 # To prevent unexpected behavior in these applications, it's also required to
76 # change the `it` value in terminfo when altering this setting.
79 # Font configuration (changes require restart)
81 # Normal (roman) font face
88 # - (Windows) Consolas
91 # The `style` can be specified to pick a specific face.
98 # If the bold family is not specified, it will fall back to the
99 # value specified for the normal font.
102 # The `style` can be specified to pick a specific face.
109 # If the italic 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.
119 # Offset is the extra space around each character. `offset.y` can be thought of
120 # as modifying the line spacing, and `offset.x` as modifying the letter spacing.
125 # Glyph offset determines the locations of the glyphs within their cells with
126 # the default being at the bottom. Increasing `x` moves the glyph to the right,
127 # increasing `y` moves the glyph upwards.
132 # Thin stroke font rendering (macOS only)
134 # Thin strokes are suitable for retina displays, but for non-retina screens
135 # it is recommended to set `use_thin_strokes` to `false`
139 # If the font quality on non-retina display looks bad then set
140 # `use_thin_strokes` to `true` and enable font smoothing by running the
142 # `defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO`
144 # This is a global setting and will require a log out or restart to take
146 use_thin_strokes: true
148 # Display the time it takes to redraw each frame.
151 # Keep the log file after quitting Alacritty.
152 persistent_logging: false
154 # If `true`, bold text is drawn using the bright color variants.
155 draw_bold_text_with_bright_colors: true
157 # Colors (Tomorrow Night Bright)
161 background: '0x000000'
162 foreground: '0xeaeaea'
164 # Bright and dim foreground colors
166 # The dimmed foreground color is calculated automatically if it is not present.
167 # If the bright foreground color is not set, or `draw_bold_text_with_bright_colors`
168 # is `false`, the normal foreground color will be used.
169 #dim_foreground: '0x9a9a9a'
170 #bright_foreground: '0xffffff'
174 # Colors which should be used to draw the terminal cursor. If these are unset,
175 # the cursor color will be the inverse of the cell color.
204 # If the dim colors are not set, they will be calculated automatically based
205 # on the `normal` colors.
212 # magenta: '0x80638e'
218 # The indexed colors include all colors from 16 to 256.
219 # When these are not set, they're filled with sensible defaults.
222 # `- { index: 16, color: '0xff00ff' }`
228 # Any time the BEL code is received, Alacritty "rings" the visual bell. Once
229 # rung, the terminal background will be set to white and transition back to the
230 # default background color. You can control the rate of this transition by
231 # setting the `duration` property (represented in milliseconds). You can also
232 # configure the transition function by setting the `animation` property.
234 # Values for `animation`:
246 # Specifying a `duration` of `0` will disable the visual bell.
248 animation: EaseOutExpo
254 # Window opacity as a floating point number from `0.0` to `1.0`.
255 # The value `0.0` is completely transparent and `1.0` is opaque.
256 background_opacity: 1.0
265 # Values for `mouse`:
269 # - Numeric identifier such as `5`
271 # All available `mods` and `action` values are documented in the key binding
274 - { mouse: Middle, action: PasteSelection }
279 # The `double_click` and `triple_click` settings control the time
280 # alacritty should wait for accepting multiple clicks as one double
282 double_click: { threshold: 300 }
283 triple_click: { threshold: 300 }
285 # If this is `true`, the cursor is temporarily hidden when typing.
286 hide_when_typing: false
291 # This program is executed when clicking on a text which is recognized as a URL.
292 # The URL is always added to the command as the last parameter.
294 # When set to `None`, URL launching will be disabled completely.
299 # - (Windows) explorer
304 # These are the modifiers that need to be held down for opening URLs when clicking
305 # on them. The available modifiers are documented in the key binding section.
309 semantic_escape_chars: ",│`|:\"' ()[]{}<>"
311 # When set to `true`, selected text will be copied to the primary clipboard.
312 save_to_clipboard: false
314 # Allow terminal applications to change Alacritty's window title.
320 # Values for `style`:
326 # If this is `true`, the cursor will be rendered as a hollow box when the
327 # window is not focused.
328 unfocused_hollow: true
330 # Live config reload (changes require restart)
331 live_config_reload: true
335 # You can set `shell.program` to the path of your favorite shell, e.g. `/bin/fish`.
336 # Entries in `shell.args` are passed unmodified as arguments to the shell.
339 # - (Linux/macOS) /bin/bash --login
340 # - (Windows) powershell
346 # Windows 10 ConPTY backend (Windows only)
348 # This will enable better color support and may resolve other issues,
349 # however this API and its implementation is still young and so is
350 # disabled by default, as stability may not be as good as the winpty
353 # Alacritty will fall back to the WinPTY automatically if the ConPTY
354 # backend cannot be initialized.
355 enable_experimental_conpty_backend: false
357 # Send ESC (\x1b) before characters when alt is pressed.
362 # Key bindings are specified as a list of objects. Each binding will specify a
363 # key and modifiers required to trigger it, terminal modes where the binding is
364 # applicable, and what should be done when the key binding fires. It can either
365 # send a byte sequence to the running application (`chars`), execute a
366 # predefined action (`action`) or fork and execute a specified command plus
367 # arguments (`command`).
369 # Bindings are always filled by default, but will be replaced when a new binding
370 # with the same triggers is defined. To unset a default binding, it can be
371 # mapped to the `None` action.
374 # `- { key: V, mods: Control|Shift, action: Paste }`
379 # - chars | action | command (exactly one required)
387 # A full list with available key codes can be found here:
388 # https://docs.rs/glutin/*/glutin/enum.VirtualKeyCode.html#variants
390 # Instead of using the name of the keys, the `key` field also supports using
391 # the scancode of the desired key. Scancodes have to be specified as a
393 # This command will allow you to display the hex scancodes for certain keys:
394 # `showkey --scancodes`
403 # Multiple `mods` can be combined using `|` like this: `mods: Control|Shift`.
404 # Whitespace and capitalization is relevant and must match the example.
406 # Values for `chars`:
407 # The `chars` field writes the specified string to the terminal. This makes
408 # it possible to pass escape sequences.
409 # To find escape codes for bindings like `PageUp` ("\x1b[5~"), you can run
410 # the command `showkey -a` outside of tmux.
411 # Note that applications use terminfo to map escape sequences back to
412 # keys. It is therefore required to update the terminfo when
413 # changing an escape sequence.
415 # Values for `action`:
433 # Values for `command`:
434 # The `command` field must be a map containing a `program` string and
435 # an `args` array of command line parameter strings.
438 # `command: { program: "alacritty", args: ["-e", "vttest"] }`
446 # (Windows/Linux only)
447 #- { key: V, mods: Control|Shift, action: Paste }
448 #- { key: C, mods: Control|Shift, action: Copy }
449 #- { key: Insert, mods: Shift, action: PasteSelection }
450 #- { key: Key0, mods: Control, action: ResetFontSize }
451 #- { key: Equals, mods: Control, action: IncreaseFontSize }
452 #- { key: Subtract, mods: Control, action: DecreaseFontSize }
455 #- { key: Key0, mods: Command, action: ResetFontSize }
456 #- { key: Equals, mods: Command, action: IncreaseFontSize }
457 #- { key: Minus, mods: Command, action: DecreaseFontSize }
458 #- { key: K, mods: Command, action: ClearHistory }
459 #- { key: K, mods: Command, chars: "\x0c" }
460 #- { key: V, mods: Command, action: Paste }
461 #- { key: C, mods: Command, action: Copy }
462 #- { key: H, mods: Command, action: Hide }
463 #- { key: Q, mods: Command, action: Quit }
464 #- { key: W, mods: Command, action: Quit }
466 - { key: Paste, action: Paste }
467 - { key: Copy, action: Copy }
468 - { key: L, mods: Control, action: ClearLogNotice }
469 - { key: L, mods: Control, chars: "\x0c" }
470 - { key: Home, chars: "\x1bOH", mode: AppCursor }
471 - { key: Home, chars: "\x1b[H", mode: ~AppCursor }
472 - { key: End, chars: "\x1bOF", mode: AppCursor }
473 - { key: End, chars: "\x1b[F", mode: ~AppCursor }
474 - { key: PageUp, mods: Shift, action: ScrollPageUp, mode: ~Alt }
475 - { key: PageUp, mods: Shift, chars: "\x1b[5;2~", mode: Alt }
476 - { key: PageUp, mods: Control, chars: "\x1b[5;5~" }
477 - { key: PageUp, chars: "\x1b[5~" }
478 - { key: PageDown, mods: Shift, action: ScrollPageDown, mode: ~Alt }
479 - { key: PageDown, mods: Shift, chars: "\x1b[6;2~", mode: Alt }
480 - { key: PageDown, mods: Control, chars: "\x1b[6;5~" }
481 - { key: PageDown, chars: "\x1b[6~" }
482 - { key: Tab, mods: Shift, chars: "\x1b[Z" }
483 - { key: Back, chars: "\x7f" }
484 - { key: Back, mods: Alt, chars: "\x1b\x7f" }
485 - { key: Insert, chars: "\x1b[2~" }
486 - { key: Delete, chars: "\x1b[3~" }
487 - { key: Left, mods: Shift, chars: "\x1b[1;2D" }
488 - { key: Left, mods: Control, chars: "\x1b[1;5D" }
489 - { key: Left, mods: Alt, chars: "\x1b[1;3D" }
490 - { key: Left, chars: "\x1b[D", mode: ~AppCursor }
491 - { key: Left, chars: "\x1bOD", mode: AppCursor }
492 - { key: Right, mods: Shift, chars: "\x1b[1;2C" }
493 - { key: Right, mods: Control, chars: "\x1b[1;5C" }
494 - { key: Right, mods: Alt, chars: "\x1b[1;3C" }
495 - { key: Right, chars: "\x1b[C", mode: ~AppCursor }
496 - { key: Right, chars: "\x1bOC", mode: AppCursor }
497 - { key: Up, mods: Shift, chars: "\x1b[1;2A" }
498 - { key: Up, mods: Control, chars: "\x1b[1;5A" }
499 - { key: Up, mods: Alt, chars: "\x1b[1;3A" }
500 - { key: Up, chars: "\x1b[A", mode: ~AppCursor }
501 - { key: Up, chars: "\x1bOA", mode: AppCursor }
502 - { key: Down, mods: Shift, chars: "\x1b[1;2B" }
503 - { key: Down, mods: Control, chars: "\x1b[1;5B" }
504 - { key: Down, mods: Alt, chars: "\x1b[1;3B" }
505 - { key: Down, chars: "\x1b[B", mode: ~AppCursor }
506 - { key: Down, chars: "\x1bOB", mode: AppCursor }
507 - { key: F1, chars: "\x1bOP" }
508 - { key: F2, chars: "\x1bOQ" }
509 - { key: F3, chars: "\x1bOR" }
510 - { key: F4, chars: "\x1bOS" }
511 - { key: F5, chars: "\x1b[15~" }
512 - { key: F6, chars: "\x1b[17~" }
513 - { key: F7, chars: "\x1b[18~" }
514 - { key: F8, chars: "\x1b[19~" }
515 - { key: F9, chars: "\x1b[20~" }
516 - { key: F10, chars: "\x1b[21~" }
517 - { key: F11, chars: "\x1b[23~" }
518 - { key: F12, chars: "\x1b[24~" }
519 - { key: F1, mods: Shift, chars: "\x1b[1;2P" }
520 - { key: F2, mods: Shift, chars: "\x1b[1;2Q" }
521 - { key: F3, mods: Shift, chars: "\x1b[1;2R" }
522 - { key: F4, mods: Shift, chars: "\x1b[1;2S" }
523 - { key: F5, mods: Shift, chars: "\x1b[15;2~" }
524 - { key: F6, mods: Shift, chars: "\x1b[17;2~" }
525 - { key: F7, mods: Shift, chars: "\x1b[18;2~" }
526 - { key: F8, mods: Shift, chars: "\x1b[19;2~" }
527 - { key: F9, mods: Shift, chars: "\x1b[20;2~" }
528 - { key: F10, mods: Shift, chars: "\x1b[21;2~" }
529 - { key: F11, mods: Shift, chars: "\x1b[23;2~" }
530 - { key: F12, mods: Shift, chars: "\x1b[24;2~" }
531 - { key: F1, mods: Control, chars: "\x1b[1;5P" }
532 - { key: F2, mods: Control, chars: "\x1b[1;5Q" }
533 - { key: F3, mods: Control, chars: "\x1b[1;5R" }
534 - { key: F4, mods: Control, chars: "\x1b[1;5S" }
535 - { key: F5, mods: Control, chars: "\x1b[15;5~" }
536 - { key: F6, mods: Control, chars: "\x1b[17;5~" }
537 - { key: F7, mods: Control, chars: "\x1b[18;5~" }
538 - { key: F8, mods: Control, chars: "\x1b[19;5~" }
539 - { key: F9, mods: Control, chars: "\x1b[20;5~" }
540 - { key: F10, mods: Control, chars: "\x1b[21;5~" }
541 - { key: F11, mods: Control, chars: "\x1b[23;5~" }
542 - { key: F12, mods: Control, chars: "\x1b[24;5~" }
543 - { key: F1, mods: Alt, chars: "\x1b[1;6P" }
544 - { key: F2, mods: Alt, chars: "\x1b[1;6Q" }
545 - { key: F3, mods: Alt, chars: "\x1b[1;6R" }
546 - { key: F4, mods: Alt, chars: "\x1b[1;6S" }
547 - { key: F5, mods: Alt, chars: "\x1b[15;6~" }
548 - { key: F6, mods: Alt, chars: "\x1b[17;6~" }
549 - { key: F7, mods: Alt, chars: "\x1b[18;6~" }
550 - { key: F8, mods: Alt, chars: "\x1b[19;6~" }
551 - { key: F9, mods: Alt, chars: "\x1b[20;6~" }
552 - { key: F10, mods: Alt, chars: "\x1b[21;6~" }
553 - { key: F11, mods: Alt, chars: "\x1b[23;6~" }
554 - { key: F12, mods: Alt, chars: "\x1b[24;6~" }
555 - { key: F1, mods: Super, chars: "\x1b[1;3P" }
556 - { key: F2, mods: Super, chars: "\x1b[1;3Q" }
557 - { key: F3, mods: Super, chars: "\x1b[1;3R" }
558 - { key: F4, mods: Super, chars: "\x1b[1;3S" }
559 - { key: F5, mods: Super, chars: "\x1b[15;3~" }
560 - { key: F6, mods: Super, chars: "\x1b[17;3~" }
561 - { key: F7, mods: Super, chars: "\x1b[18;3~" }
562 - { key: F8, mods: Super, chars: "\x1b[19;3~" }
563 - { key: F9, mods: Super, chars: "\x1b[20;3~" }
564 - { key: F10, mods: Super, chars: "\x1b[21;3~" }
565 - { key: F11, mods: Super, chars: "\x1b[23;3~" }
566 - { key: F12, mods: Super, chars: "\x1b[24;3~" }
567 - { key: NumpadEnter, chars: "\n" }