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 family: Source Code Pro
93 # The `style` can be specified to pick a specific face.
100 # If the bold family is not specified, it will fall back to the
101 # value specified for the normal font.
104 # The `style` can be specified to pick a specific face.
111 # If the italic family is not specified, it will fall back to the
112 # value specified for the normal font.
115 # The `style` can be specified to pick a specific face.
121 # Offset is the extra space around each character. `offset.y` can be thought of
122 # as modifying the line spacing, and `offset.x` as modifying the letter spacing.
127 # Glyph offset determines the locations of the glyphs within their cells with
128 # the default being at the bottom. Increasing `x` moves the glyph to the right,
129 # increasing `y` moves the glyph upwards.
134 # Thin stroke font rendering (macOS only)
136 # Thin strokes are suitable for retina displays, but for non-retina screens
137 # it is recommended to set `use_thin_strokes` to `false`
141 # If the font quality on non-retina display looks bad then set
142 # `use_thin_strokes` to `true` and enable font smoothing by running the
144 # `defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO`
146 # This is a global setting and will require a log out or restart to take
148 use_thin_strokes: true
150 # Display the time it takes to redraw each frame.
153 # Keep the log file after quitting Alacritty.
154 persistent_logging: false
156 # If `true`, bold text is drawn using the bright color variants.
157 draw_bold_text_with_bright_colors: true
159 # Colors (Tomorrow Night Bright)
163 background: '0x000000'
164 foreground: '0xeaeaea'
166 # Bright and dim foreground colors
168 # The dimmed foreground color is calculated automatically if it is not present.
169 # If the bright foreground color is not set, or `draw_bold_text_with_bright_colors`
170 # is `false`, the normal foreground color will be used.
171 #dim_foreground: '0x9a9a9a'
172 #bright_foreground: '0xffffff'
176 # Colors which should be used to draw the terminal cursor. If these are unset,
177 # the cursor color will be the inverse of the cell color.
206 # If the dim colors are not set, they will be calculated automatically based
207 # on the `normal` colors.
214 # magenta: '0x80638e'
220 # The indexed colors include all colors from 16 to 256.
221 # When these are not set, they're filled with sensible defaults.
224 # `- { index: 16, color: '0xff00ff' }`
230 # Any time the BEL code is received, Alacritty "rings" the visual bell. Once
231 # rung, the terminal background will be set to white and transition back to the
232 # default background color. You can control the rate of this transition by
233 # setting the `duration` property (represented in milliseconds). You can also
234 # configure the transition function by setting the `animation` property.
236 # Values for `animation`:
248 # Specifying a `duration` of `0` will disable the visual bell.
250 animation: EaseOutExpo
256 # Window opacity as a floating point number from `0.0` to `1.0`.
257 # The value `0.0` is completely transparent and `1.0` is opaque.
258 background_opacity: 1.0
267 # Values for `mouse`:
271 # - Numeric identifier such as `5`
273 # All available `mods` and `action` values are documented in the key binding
276 - { mouse: Middle, action: PasteSelection }
281 # The `double_click` and `triple_click` settings control the time
282 # alacritty should wait for accepting multiple clicks as one double
284 double_click: { threshold: 300 }
285 triple_click: { threshold: 300 }
287 # If this is `true`, the cursor is temporarily hidden when typing.
288 hide_when_typing: false
293 # This program is executed when clicking on a text which is recognized as a URL.
294 # The URL is always added to the command as the last parameter.
296 # When set to `None`, URL launching will be disabled completely.
301 # - (Windows) explorer
306 # These are the modifiers that need to be held down for opening URLs when clicking
307 # on them. The available modifiers are documented in the key binding section.
311 semantic_escape_chars: ",│`|:\"' ()[]{}<>"
313 # When set to `true`, selected text will be copied to the primary clipboard.
314 save_to_clipboard: false
316 # Allow terminal applications to change Alacritty's window title.
322 # Values for `style`:
328 # If this is `true`, the cursor will be rendered as a hollow box when the
329 # window is not focused.
330 unfocused_hollow: true
332 # Live config reload (changes require restart)
333 live_config_reload: true
337 # You can set `shell.program` to the path of your favorite shell, e.g. `/bin/fish`.
338 # Entries in `shell.args` are passed unmodified as arguments to the shell.
341 # - (Linux/macOS) /bin/bash --login
342 # - (Windows) powershell
348 # Windows 10 ConPTY backend (Windows only)
350 # This will enable better color support and may resolve other issues,
351 # however this API and its implementation is still young and so is
352 # disabled by default, as stability may not be as good as the winpty
355 # Alacritty will fall back to the WinPTY automatically if the ConPTY
356 # backend cannot be initialized.
357 enable_experimental_conpty_backend: false
359 # Send ESC (\x1b) before characters when alt is pressed.
364 # Key bindings are specified as a list of objects. Each binding will specify a
365 # key and modifiers required to trigger it, terminal modes where the binding is
366 # applicable, and what should be done when the key binding fires. It can either
367 # send a byte sequence to the running application (`chars`), execute a
368 # predefined action (`action`) or fork and execute a specified command plus
369 # arguments (`command`).
371 # Bindings are always filled by default, but will be replaced when a new binding
372 # with the same triggers is defined. To unset a default binding, it can be
373 # mapped to the `None` action.
376 # `- { key: V, mods: Control|Shift, action: Paste }`
381 # - chars | action | command (exactly one required)
389 # A full list with available key codes can be found here:
390 # https://docs.rs/glutin/*/glutin/enum.VirtualKeyCode.html#variants
392 # Instead of using the name of the keys, the `key` field also supports using
393 # the scancode of the desired key. Scancodes have to be specified as a
395 # This command will allow you to display the hex scancodes for certain keys:
396 # `showkey --scancodes`
405 # Multiple `mods` can be combined using `|` like this: `mods: Control|Shift`.
406 # Whitespace and capitalization is relevant and must match the example.
408 # Values for `chars`:
409 # The `chars` field writes the specified string to the terminal. This makes
410 # it possible to pass escape sequences.
411 # To find escape codes for bindings like `PageUp` ("\x1b[5~"), you can run
412 # the command `showkey -a` outside of tmux.
413 # Note that applications use terminfo to map escape sequences back to
414 # keys. It is therefore required to update the terminfo when
415 # changing an escape sequence.
417 # Values for `action`:
435 # Values for `command`:
436 # The `command` field must be a map containing a `program` string and
437 # an `args` array of command line parameter strings.
440 # `command: { program: "alacritty", args: ["-e", "vttest"] }`
448 # (Windows/Linux only)
449 #- { key: V, mods: Control|Shift, action: Paste }
450 #- { key: C, mods: Control|Shift, action: Copy }
451 #- { key: Insert, mods: Shift, action: PasteSelection }
452 #- { key: Key0, mods: Control, action: ResetFontSize }
453 #- { key: Equals, mods: Control, action: IncreaseFontSize }
454 #- { key: Subtract, mods: Control, action: DecreaseFontSize }
457 #- { key: Key0, mods: Command, action: ResetFontSize }
458 #- { key: Equals, mods: Command, action: IncreaseFontSize }
459 #- { key: Minus, mods: Command, action: DecreaseFontSize }
460 #- { key: K, mods: Command, action: ClearHistory }
461 #- { key: K, mods: Command, chars: "\x0c" }
462 #- { key: V, mods: Command, action: Paste }
463 #- { key: C, mods: Command, action: Copy }
464 #- { key: H, mods: Command, action: Hide }
465 #- { key: Q, mods: Command, action: Quit }
466 #- { key: W, mods: Command, action: Quit }
468 - { key: Paste, action: Paste }
469 - { key: Copy, action: Copy }
470 - { key: L, mods: Control, action: ClearLogNotice }
471 - { key: L, mods: Control, chars: "\x0c" }
472 - { key: Home, chars: "\x1bOH", mode: AppCursor }
473 - { key: Home, chars: "\x1b[H", mode: ~AppCursor }
474 - { key: End, chars: "\x1bOF", mode: AppCursor }
475 - { key: End, chars: "\x1b[F", mode: ~AppCursor }
476 - { key: PageUp, mods: Shift, action: ScrollPageUp, mode: ~Alt }
477 - { key: PageUp, mods: Shift, chars: "\x1b[5;2~", mode: Alt }
478 - { key: PageUp, mods: Control, chars: "\x1b[5;5~" }
479 - { key: PageUp, chars: "\x1b[5~" }
480 - { key: PageDown, mods: Shift, action: ScrollPageDown, mode: ~Alt }
481 - { key: PageDown, mods: Shift, chars: "\x1b[6;2~", mode: Alt }
482 - { key: PageDown, mods: Control, chars: "\x1b[6;5~" }
483 - { key: PageDown, chars: "\x1b[6~" }
484 - { key: Tab, mods: Shift, chars: "\x1b[Z" }
485 - { key: Back, chars: "\x7f" }
486 - { key: Back, mods: Alt, chars: "\x1b\x7f" }
487 - { key: Insert, chars: "\x1b[2~" }
488 - { key: Delete, chars: "\x1b[3~" }
489 - { key: Left, mods: Shift, chars: "\x1b[1;2D" }
490 - { key: Left, mods: Control, chars: "\x1b[1;5D" }
491 - { key: Left, mods: Alt, chars: "\x1b[1;3D" }
492 - { key: Left, chars: "\x1b[D", mode: ~AppCursor }
493 - { key: Left, chars: "\x1bOD", mode: AppCursor }
494 - { key: Right, mods: Shift, chars: "\x1b[1;2C" }
495 - { key: Right, mods: Control, chars: "\x1b[1;5C" }
496 - { key: Right, mods: Alt, chars: "\x1b[1;3C" }
497 - { key: Right, chars: "\x1b[C", mode: ~AppCursor }
498 - { key: Right, chars: "\x1bOC", mode: AppCursor }
499 - { key: Up, mods: Shift, chars: "\x1b[1;2A" }
500 - { key: Up, mods: Control, chars: "\x1b[1;5A" }
501 - { key: Up, mods: Alt, chars: "\x1b[1;3A" }
502 - { key: Up, chars: "\x1b[A", mode: ~AppCursor }
503 - { key: Up, chars: "\x1bOA", mode: AppCursor }
504 - { key: Down, mods: Shift, chars: "\x1b[1;2B" }
505 - { key: Down, mods: Control, chars: "\x1b[1;5B" }
506 - { key: Down, mods: Alt, chars: "\x1b[1;3B" }
507 - { key: Down, chars: "\x1b[B", mode: ~AppCursor }
508 - { key: Down, chars: "\x1bOB", mode: AppCursor }
509 - { key: F1, chars: "\x1bOP" }
510 - { key: F2, chars: "\x1bOQ" }
511 - { key: F3, chars: "\x1bOR" }
512 - { key: F4, chars: "\x1bOS" }
513 - { key: F5, chars: "\x1b[15~" }
514 - { key: F6, chars: "\x1b[17~" }
515 - { key: F7, chars: "\x1b[18~" }
516 - { key: F8, chars: "\x1b[19~" }
517 - { key: F9, chars: "\x1b[20~" }
518 - { key: F10, chars: "\x1b[21~" }
519 - { key: F11, chars: "\x1b[23~" }
520 - { key: F12, chars: "\x1b[24~" }
521 - { key: F1, mods: Shift, chars: "\x1b[1;2P" }
522 - { key: F2, mods: Shift, chars: "\x1b[1;2Q" }
523 - { key: F3, mods: Shift, chars: "\x1b[1;2R" }
524 - { key: F4, mods: Shift, chars: "\x1b[1;2S" }
525 - { key: F5, mods: Shift, chars: "\x1b[15;2~" }
526 - { key: F6, mods: Shift, chars: "\x1b[17;2~" }
527 - { key: F7, mods: Shift, chars: "\x1b[18;2~" }
528 - { key: F8, mods: Shift, chars: "\x1b[19;2~" }
529 - { key: F9, mods: Shift, chars: "\x1b[20;2~" }
530 - { key: F10, mods: Shift, chars: "\x1b[21;2~" }
531 - { key: F11, mods: Shift, chars: "\x1b[23;2~" }
532 - { key: F12, mods: Shift, chars: "\x1b[24;2~" }
533 - { key: F1, mods: Control, chars: "\x1b[1;5P" }
534 - { key: F2, mods: Control, chars: "\x1b[1;5Q" }
535 - { key: F3, mods: Control, chars: "\x1b[1;5R" }
536 - { key: F4, mods: Control, chars: "\x1b[1;5S" }
537 - { key: F5, mods: Control, chars: "\x1b[15;5~" }
538 - { key: F6, mods: Control, chars: "\x1b[17;5~" }
539 - { key: F7, mods: Control, chars: "\x1b[18;5~" }
540 - { key: F8, mods: Control, chars: "\x1b[19;5~" }
541 - { key: F9, mods: Control, chars: "\x1b[20;5~" }
542 - { key: F10, mods: Control, chars: "\x1b[21;5~" }
543 - { key: F11, mods: Control, chars: "\x1b[23;5~" }
544 - { key: F12, mods: Control, chars: "\x1b[24;5~" }
545 - { key: F1, mods: Alt, chars: "\x1b[1;6P" }
546 - { key: F2, mods: Alt, chars: "\x1b[1;6Q" }
547 - { key: F3, mods: Alt, chars: "\x1b[1;6R" }
548 - { key: F4, mods: Alt, chars: "\x1b[1;6S" }
549 - { key: F5, mods: Alt, chars: "\x1b[15;6~" }
550 - { key: F6, mods: Alt, chars: "\x1b[17;6~" }
551 - { key: F7, mods: Alt, chars: "\x1b[18;6~" }
552 - { key: F8, mods: Alt, chars: "\x1b[19;6~" }
553 - { key: F9, mods: Alt, chars: "\x1b[20;6~" }
554 - { key: F10, mods: Alt, chars: "\x1b[21;6~" }
555 - { key: F11, mods: Alt, chars: "\x1b[23;6~" }
556 - { key: F12, mods: Alt, chars: "\x1b[24;6~" }
557 - { key: F1, mods: Super, chars: "\x1b[1;3P" }
558 - { key: F2, mods: Super, chars: "\x1b[1;3Q" }
559 - { key: F3, mods: Super, chars: "\x1b[1;3R" }
560 - { key: F4, mods: Super, chars: "\x1b[1;3S" }
561 - { key: F5, mods: Super, chars: "\x1b[15;3~" }
562 - { key: F6, mods: Super, chars: "\x1b[17;3~" }
563 - { key: F7, mods: Super, chars: "\x1b[18;3~" }
564 - { key: F8, mods: Super, chars: "\x1b[19;3~" }
565 - { key: F9, mods: Super, chars: "\x1b[20;3~" }
566 - { key: F10, mods: Super, chars: "\x1b[21;3~" }
567 - { key: F11, mods: Super, chars: "\x1b[23;3~" }
568 - { key: F12, mods: Super, chars: "\x1b[24;3~" }
569 - { key: NumpadEnter, chars: "\n" }