1 # defaults are in /a/opt/alacritty/alacritty.yml
6 # Configuration for Alacritty, the GPU enhanced terminal emulator.
8 # Import additional configuration files
10 # Imports are loaded in order, skipping all missing files, with the importing
11 # file being loaded last. If a field is already present in a previous import, it
14 # All imports must either be absolute paths starting with `/`, or paths relative
15 # to the user's home directory starting with `~/`.
17 # - /path/to/alacritty.yml
19 # Any items in the `env` entry below will be added as
20 # environment variables. Some entries may override variables
21 # set by alacritty itself.
25 # This value is used to set the `$TERM` environment variable for
26 # each instance of Alacritty. If it is not present, alacritty will
27 # check the local terminfo database and use `alacritty` if it is
28 # available, otherwise `xterm-256color` is used.
32 # Window dimensions (changes require restart)
34 # Number of lines/columns (not pixels) in the terminal. The number of columns
35 # must be at least `2`, while using a value of `0` for columns and lines will
36 # fall back to the window manager's recommended size.
41 # Window position (changes require restart)
43 # Specified in number of pixels.
44 # If the position is not set, the window manager will handle the placement.
49 # Window padding (changes require restart)
51 # Blank space added around the window in pixels. This padding is scaled
52 # by DPI and the specified value is always added at both opposing sides.
57 # Spread additional padding evenly around the terminal content.
58 #dynamic_padding: false
62 # Values for `decorations`:
63 # - full: Borders and title bar
64 # - none: Neither borders nor title bar
66 # Values for `decorations` (macOS only):
67 # - transparent: Title bar, transparent background and title bar buttons
68 # - buttonless: Title bar, transparent background and no title bar buttons
73 # Window opacity as a floating point number from `0.0` to `1.0`.
74 # The value `0.0` is completely transparent and `1.0` is opaque.
77 # Startup Mode (changes require restart)
79 # Values for `startup_mode`:
84 # Values for `startup_mode` (macOS only):
86 #startup_mode: Windowed
91 # Allow terminal applications to change Alacritty's window title.
94 # Window class (Linux/BSD only):
96 # Application instance name
98 # General application class
101 # GTK theme variant (Linux/BSD only)
103 # Override the variant of the GTK theme. Commonly supported values are `dark`
104 # and `light`. Set this to `None` to use the default theme variant.
105 #gtk_theme_variant: None
108 # Maximum number of lines in the scrollback buffer.
109 # Specifying '0' will disable scrolling.
112 # Scrolling distance multiplier.
117 # Normal (roman) font face
123 # - (Linux/BSD) monospace
124 # - (Windows) Consolas
127 # The `style` can be specified to pick a specific face.
134 # If the bold family is not specified, it will fall back to the
135 # value specified for the normal font.
138 # The `style` can be specified to pick a specific face.
145 # If the italic family is not specified, it will fall back to the
146 # value specified for the normal font.
149 # The `style` can be specified to pick a specific face.
152 # Bold italic font face
156 # If the bold italic family is not specified, it will fall back to the
157 # value specified for the normal font.
160 # The `style` can be specified to pick a specific face.
166 # Offset is the extra space around each character. `offset.y` can be thought
167 # of as modifying the line spacing, and `offset.x` as modifying the letter
173 # Glyph offset determines the locations of the glyphs within their cells with
174 # the default being at the bottom. Increasing `x` moves the glyph to the
175 # right, increasing `y` moves the glyph upward.
180 # Thin stroke font rendering (macOS only)
182 # Thin strokes are suitable for retina displays, but for non-retina screens
183 # it is recommended to set `use_thin_strokes` to `false`.
184 #use_thin_strokes: true
186 # If `true`, bold text is drawn using the bright color variants.
187 #draw_bold_text_with_bright_colors: false
189 # Colors (Tomorrow Night)
193 # background: '#1d1f21'
194 # foreground: '#c5c8c6'
196 # Bright and dim foreground colors
198 # The dimmed foreground color is calculated automatically if it is not
199 # present. If the bright foreground color is not set, or
200 # `draw_bold_text_with_bright_colors` is `false`, the normal foreground
201 # color will be used.
202 #dim_foreground: '#828482'
203 #bright_foreground: '#eaeaea'
207 # Colors which should be used to draw the terminal cursor.
209 # Allowed values are CellForeground/CellBackground, which reference the
210 # affected cell, or hexadecimal colors like #ff00ff.
212 # text: CellBackground
213 # cursor: CellForeground
215 # Vi mode cursor colors
217 # Colors for the cursor when the vi mode is active.
219 # Allowed values are CellForeground/CellBackground, which reference the
220 # affected cell, or hexadecimal colors like #ff00ff.
222 # text: CellBackground
223 # cursor: CellForeground
227 # Colors used for the search bar and match highlighting.
229 # Allowed values are CellForeground/CellBackground, which reference the
230 # affected cell, or hexadecimal colors like #ff00ff.
232 # foreground: '#000000'
233 # background: '#ffffff'
235 # foreground: '#ffffff'
236 # background: '#000000'
239 # background: '#c5c8c6'
240 # foreground: '#1d1f21'
242 # Keyboard regex hints
244 # First character in the hint label
246 # Allowed values are CellForeground/CellBackground, which reference the
247 # affected cell, or hexadecimal colors like #ff00ff.
249 # foreground: '#1d1f21'
250 # background: '#e9ff5e'
252 # All characters after the first one in the hint label
254 # Allowed values are CellForeground/CellBackground, which reference the
255 # affected cell, or hexadecimal colors like #ff00ff.
257 # foreground: '#e9ff5e'
258 # background: '#1d1f21'
262 # Color used for the indicator displaying the position in history during
263 # search and vi mode.
265 # By default, these will use the opposing primary color.
272 # Colors which should be used to draw the selection area.
274 # Allowed values are CellForeground/CellBackground, which reference the
275 # affected cell, or hexadecimal colors like #ff00ff.
277 # text: CellBackground
278 # background: CellForeground
304 # If the dim colors are not set, they will be calculated automatically based
305 # on the `normal` colors.
318 # The indexed colors include all colors from 16 to 256.
319 # When these are not set, they're filled with sensible defaults.
322 # `- { index: 16, color: '#ff00ff' }`
326 # Transparent cell backgrounds
328 # Whether or not `window.opacity` applies to all cell backgrounds or only to
329 # the default background. When set to `true` all cells will be transparent
330 # regardless of their background color.
331 #transparent_background_colors: false
335 # The bell is rung every time the BEL control character is received.
337 # Visual Bell Animation
339 # Animation effect for flashing the screen when the visual bell is rung.
341 # Values for `animation`:
352 #animation: EaseOutExpo
354 # Duration of the visual bell flash in milliseconds. A `duration` of `0` will
355 # disable the visual bell animation.
358 # Visual bell animation color.
363 # This program is executed whenever the bell is rung.
365 # When set to `command: None`, no command will be executed.
369 # program: notify-send
370 # args: ["Hello, World!"]
375 # This string contains all characters that are used as separators for
376 # "semantic words" in Alacritty.
377 #semantic_escape_chars: ",│`|:\"' ()[]{}<>\t"
379 # When set to `true`, selected text will be copied to the primary clipboard.
380 #save_to_clipboard: false
387 # Values for `shape`:
393 # Cursor blinking state
395 # Values for `blinking`:
396 # - Never: Prevent the cursor from ever blinking
397 # - Off: Disable blinking by default
398 # - On: Enable blinking by default
399 # - Always: Force the cursor to always blink
402 # Vi mode cursor style
404 # If the vi mode cursor style is `None` or not specified, it will fall back to
405 # the style of the active value of the normal cursor.
407 # See `cursor.style` for available options.
410 # Cursor blinking interval in milliseconds.
413 # If this is `true`, the cursor will be rendered as a hollow box when the
414 # window is not focused.
415 #unfocused_hollow: true
417 # Thickness of the cursor relative to the cell width as floating point number
418 # from `0.0` to `1.0`.
421 # Live config reload (changes require restart)
422 #live_config_reload: true
426 # You can set `shell.program` to the path of your favorite shell, e.g.
427 # `/bin/fish`. Entries in `shell.args` are passed unmodified as arguments to the
431 # - (macOS) /bin/bash --login
432 # - (Linux/BSD) user login shell
433 # - (Windows) powershell
441 # Directory the shell is started in. If this is unset, or `None`, the working
442 # directory of the parent process will be used.
443 #working_directory: None
445 # Send ESC (\x1b) before characters when alt is pressed.
448 # Offer IPC using `alacritty msg` (unix only)
454 # The `double_click` and `triple_click` settings control the time
455 # alacritty should wait for accepting multiple clicks as one double
457 #double_click: { threshold: 300 }
458 #triple_click: { threshold: 300 }
460 # If this is `true`, the cursor is temporarily hidden when typing.
461 #hide_when_typing: false
465 # Terminal hints can be used to find text in the visible part of the terminal
466 # and pipe it to other applications.
468 # Keys used for the hint labels.
469 #alphabet: "jfkdls;ahgurieowpq"
471 # List with all available hints
473 # Each hint must have a `regex` and either an `action` or a `command` field.
474 # The fields `mouse`, `binding` and `post_processing` are optional.
476 # The fields `command`, `binding.key`, `binding.mods`, `binding.mode` and
477 # `mouse.mods` accept the same values as they do in the `key_bindings` section.
479 # The `mouse.enabled` field controls if the hint should be underlined while
480 # the mouse with all `mouse.mods` keys held or the vi mode cursor is above it.
482 # If the `post_processing` field is set to `true`, heuristics will be used to
483 # shorten the match if there are characters likely not to be part of the hint
484 # (e.g. a trailing `.`). This is most useful for URIs.
486 # Values for `action`:
488 # Copy the hint's text to the clipboard.
490 # Paste the hint's text to the terminal or search.
492 # Select the hint's text.
494 # Move the vi mode cursor to the beginning of the hint.
496 # - regex: "(ipfs:|ipns:|magnet:|mailto:|gemini:|gopher:|https:|http:|news:|file:|git:|ssh:|ftp:)\
497 # [^\u0000-\u001F\u007F-\u009F<>\"\\s{-}\\^⟨⟩`]+"
499 # post_processing: true
505 # mods: Control|Shift
509 # Mouse bindings are specified as a list of objects, much like the key
510 # bindings further below.
512 # To trigger mouse bindings when an application running within Alacritty
513 # captures the mouse, the `Shift` modifier is automatically added as a
516 # Each mouse binding will specify a:
523 # - Numeric identifier such as `5`
525 # - `action` (see key bindings for actions not exclusive to mouse mode)
527 # - Mouse exclusive actions:
530 # Expand the selection to the current mouse cursor location.
534 # - `mods` (see key bindings)
536 # - { mouse: Right, action: ExpandSelection }
537 # - { mouse: Middle, mode: ~Vi, action: PasteSelection }
541 # Key bindings are specified as a list of objects. For example, this is the
542 # default paste binding:
544 # `- { key: V, mods: Control|Shift, action: Paste }`
546 # Each key binding will specify a:
548 # - `key`: Identifier of the key pressed
554 # A full list with available key codes can be found here:
555 # https://docs.rs/glutin/*/glutin/event/enum.VirtualKeyCode.html#variants
557 # Instead of using the name of the keys, the `key` field also supports using
558 # the scancode of the desired key. Scancodes have to be specified as a
559 # decimal number. This command will allow you to display the hex scancodes
562 # `showkey --scancodes`.
564 # Then exactly one of:
566 # - `chars`: Send a byte sequence to the running application
568 # The `chars` field writes the specified string to the terminal. This makes
569 # it possible to pass escape sequences. To find escape codes for bindings
570 # like `PageUp` (`"\x1b[5~"`), you can run the command `showkey -a` outside
571 # of tmux. Note that applications use terminfo to map escape sequences back
572 # to keys. It is therefore required to update the terminfo when changing an
575 # - `action`: Execute a predefined action
579 # Start searching toward the right of the search origin.
581 # Start searching toward the left of the search origin.
590 # - ScrollHalfPageDown
596 # Remove the terminal's scrollback history.
598 # Hide the Alacritty window.
600 # Minimize the Alacritty window.
605 # Spawn a new instance of Alacritty.
607 # Create a new Alacritty window from the current process.
609 # Clear Alacritty's UI warning and error notice.
611 # Remove the active selection.
615 # - Vi mode exclusive actions:
618 # Perform the action of the first matching hint under the vi mode cursor
619 # with `mouse.enabled` set to `true`.
620 # - ToggleNormalSelection
621 # - ToggleLineSelection
622 # - ToggleBlockSelection
623 # - ToggleSemanticSelection
624 # Toggle semantic selection based on `selection.semantic_escape_chars`.
626 # - Vi mode exclusive cursor motion actions:
633 # One character left.
635 # One character right.
637 # First column, or beginning of the line when already at the first column.
639 # Last column, or beginning of the line when already at the last column.
641 # First non-empty cell in this terminal row, or first non-empty cell of
642 # the line when already at the first cell of the row.
646 # Center of the screen.
648 # Bottom of the screen.
650 # Start of the previous semantically separated word.
652 # Start of the next semantically separated word.
654 # End of the previous semantically separated word.
656 # End of the next semantically separated word.
658 # Start of the previous whitespace separated word.
660 # Start of the next whitespace separated word.
662 # End of the previous whitespace separated word.
664 # End of the next whitespace separated word.
666 # Character matching the bracket at the cursor's location.
668 # Beginning of the next match.
670 # Beginning of the previous match.
672 # Start of the match to the left of the vi mode cursor.
674 # End of the match to the right of the vi mode cursor.
676 # - Search mode exclusive actions:
678 # Move the focus to the next search match.
679 # - SearchFocusPrevious
680 # Move the focus to the previous search match.
684 # Reset the search regex.
686 # Delete the last word in the search regex.
687 # - SearchHistoryPrevious
688 # Go to the previous regex in the search history.
689 # - SearchHistoryNext
690 # Go to the next regex in the search history.
692 # - macOS exclusive actions:
693 # - ToggleSimpleFullscreen
694 # Enter fullscreen without occupying another space.
696 # - Linux/BSD exclusive actions:
699 # Copy from the selection buffer.
701 # Paste from the selection buffer.
703 # - `command`: Fork and execute a specified command plus arguments
705 # The `command` field must be a map containing a `program` string and an
706 # `args` array of command line parameter strings. For example:
707 # `{ program: "alacritty", args: ["-e", "vttest"] }`
711 # - `mods`: Key modifiers to filter binding actions
720 # Multiple `mods` can be combined using `|` like this:
721 # `mods: Control|Shift`.
722 # Whitespace and capitalization are relevant and must match the example.
724 # - `mode`: Indicate a binding for only specific terminal reported modes
726 # This is mainly used to send applications the correct escape sequences
727 # when in different modes.
735 # A `~` operator can be used before a mode to apply the binding whenever
736 # the mode is *not* active, e.g. `~Alt`.
738 # Bindings are always filled by default, but will be replaced when a new
739 # binding with the same triggers is defined. To unset a default binding, it can
740 # be mapped to the `ReceiveChar` action. Alternatively, you can use `None` for
741 # a no-op if you do not wish to receive input characters for that binding.
743 # If the same trigger is assigned to multiple actions, all of them are executed
744 # in the order they were defined in.
746 #- { key: Paste, action: Paste }
747 #- { key: Copy, action: Copy }
748 #- { key: L, mods: Control, action: ClearLogNotice }
749 #- { key: L, mods: Control, mode: ~Vi|~Search, chars: "\x0c" }
750 #- { key: PageUp, mods: Shift, mode: ~Alt, action: ScrollPageUp, }
751 #- { key: PageDown, mods: Shift, mode: ~Alt, action: ScrollPageDown }
752 #- { key: Home, mods: Shift, mode: ~Alt, action: ScrollToTop, }
753 #- { key: End, mods: Shift, mode: ~Alt, action: ScrollToBottom }
756 #- { key: Space, mods: Shift|Control, mode: ~Search, action: ToggleViMode }
757 #- { key: Space, mods: Shift|Control, mode: Vi|~Search, action: ScrollToBottom }
758 #- { key: Escape, mode: Vi|~Search, action: ClearSelection }
759 #- { key: I, mode: Vi|~Search, action: ToggleViMode }
760 #- { key: I, mode: Vi|~Search, action: ScrollToBottom }
761 #- { key: C, mods: Control, mode: Vi|~Search, action: ToggleViMode }
762 #- { key: Y, mods: Control, mode: Vi|~Search, action: ScrollLineUp }
763 #- { key: E, mods: Control, mode: Vi|~Search, action: ScrollLineDown }
764 #- { key: G, mode: Vi|~Search, action: ScrollToTop }
765 #- { key: G, mods: Shift, mode: Vi|~Search, action: ScrollToBottom }
766 #- { key: B, mods: Control, mode: Vi|~Search, action: ScrollPageUp }
767 #- { key: F, mods: Control, mode: Vi|~Search, action: ScrollPageDown }
768 #- { key: U, mods: Control, mode: Vi|~Search, action: ScrollHalfPageUp }
769 #- { key: D, mods: Control, mode: Vi|~Search, action: ScrollHalfPageDown }
770 #- { key: Y, mode: Vi|~Search, action: Copy }
771 #- { key: Y, mode: Vi|~Search, action: ClearSelection }
772 #- { key: Copy, mode: Vi|~Search, action: ClearSelection }
773 #- { key: V, mode: Vi|~Search, action: ToggleNormalSelection }
774 #- { key: V, mods: Shift, mode: Vi|~Search, action: ToggleLineSelection }
775 #- { key: V, mods: Control, mode: Vi|~Search, action: ToggleBlockSelection }
776 #- { key: V, mods: Alt, mode: Vi|~Search, action: ToggleSemanticSelection }
777 #- { key: Return, mode: Vi|~Search, action: Open }
778 #- { key: K, mode: Vi|~Search, action: Up }
779 #- { key: J, mode: Vi|~Search, action: Down }
780 #- { key: H, mode: Vi|~Search, action: Left }
781 #- { key: L, mode: Vi|~Search, action: Right }
782 #- { key: Up, mode: Vi|~Search, action: Up }
783 #- { key: Down, mode: Vi|~Search, action: Down }
784 #- { key: Left, mode: Vi|~Search, action: Left }
785 #- { key: Right, mode: Vi|~Search, action: Right }
786 #- { key: Key0, mode: Vi|~Search, action: First }
787 #- { key: Key4, mods: Shift, mode: Vi|~Search, action: Last }
788 #- { key: Key6, mods: Shift, mode: Vi|~Search, action: FirstOccupied }
789 #- { key: H, mods: Shift, mode: Vi|~Search, action: High }
790 #- { key: M, mods: Shift, mode: Vi|~Search, action: Middle }
791 #- { key: L, mods: Shift, mode: Vi|~Search, action: Low }
792 #- { key: B, mode: Vi|~Search, action: SemanticLeft }
793 #- { key: W, mode: Vi|~Search, action: SemanticRight }
794 #- { key: E, mode: Vi|~Search, action: SemanticRightEnd }
795 #- { key: B, mods: Shift, mode: Vi|~Search, action: WordLeft }
796 #- { key: W, mods: Shift, mode: Vi|~Search, action: WordRight }
797 #- { key: E, mods: Shift, mode: Vi|~Search, action: WordRightEnd }
798 #- { key: Key5, mods: Shift, mode: Vi|~Search, action: Bracket }
799 #- { key: Slash, mode: Vi|~Search, action: SearchForward }
800 #- { key: Slash, mods: Shift, mode: Vi|~Search, action: SearchBackward }
801 #- { key: N, mode: Vi|~Search, action: SearchNext }
802 #- { key: N, mods: Shift, mode: Vi|~Search, action: SearchPrevious }
805 #- { key: Return, mode: Search|Vi, action: SearchConfirm }
806 #- { key: Escape, mode: Search, action: SearchCancel }
807 #- { key: C, mods: Control, mode: Search, action: SearchCancel }
808 #- { key: U, mods: Control, mode: Search, action: SearchClear }
809 #- { key: W, mods: Control, mode: Search, action: SearchDeleteWord }
810 #- { key: P, mods: Control, mode: Search, action: SearchHistoryPrevious }
811 #- { key: N, mods: Control, mode: Search, action: SearchHistoryNext }
812 #- { key: Up, mode: Search, action: SearchHistoryPrevious }
813 #- { key: Down, mode: Search, action: SearchHistoryNext }
814 #- { key: Return, mode: Search|~Vi, action: SearchFocusNext }
815 #- { key: Return, mods: Shift, mode: Search|~Vi, action: SearchFocusPrevious }
817 # (Windows, Linux, and BSD only)
818 #- { key: V, mods: Control|Shift, mode: ~Vi, action: Paste }
819 #- { key: C, mods: Control|Shift, action: Copy }
820 #- { key: F, mods: Control|Shift, mode: ~Search, action: SearchForward }
821 #- { key: B, mods: Control|Shift, mode: ~Search, action: SearchBackward }
822 #- { key: C, mods: Control|Shift, mode: Vi|~Search, action: ClearSelection }
823 #- { key: Insert, mods: Shift, action: PasteSelection }
824 #- { key: Key0, mods: Control, action: ResetFontSize }
825 #- { key: Equals, mods: Control, action: IncreaseFontSize }
826 #- { key: Plus, mods: Control, action: IncreaseFontSize }
827 #- { key: NumpadAdd, mods: Control, action: IncreaseFontSize }
828 #- { key: Minus, mods: Control, action: DecreaseFontSize }
829 #- { key: NumpadSubtract, mods: Control, action: DecreaseFontSize }
832 #- { key: Return, mods: Alt, action: ToggleFullscreen }
835 #- { key: K, mods: Command, mode: ~Vi|~Search, chars: "\x0c" }
836 #- { key: K, mods: Command, mode: ~Vi|~Search, action: ClearHistory }
837 #- { key: Key0, mods: Command, action: ResetFontSize }
838 #- { key: Equals, mods: Command, action: IncreaseFontSize }
839 #- { key: Plus, mods: Command, action: IncreaseFontSize }
840 #- { key: NumpadAdd, mods: Command, action: IncreaseFontSize }
841 #- { key: Minus, mods: Command, action: DecreaseFontSize }
842 #- { key: NumpadSubtract, mods: Command, action: DecreaseFontSize }
843 #- { key: V, mods: Command, action: Paste }
844 #- { key: C, mods: Command, action: Copy }
845 #- { key: C, mods: Command, mode: Vi|~Search, action: ClearSelection }
846 #- { key: H, mods: Command, action: Hide }
847 #- { key: H, mods: Command|Alt, action: HideOtherApplications }
848 #- { key: M, mods: Command, action: Minimize }
849 #- { key: Q, mods: Command, action: Quit }
850 #- { key: W, mods: Command, action: Quit }
851 #- { key: N, mods: Command, action: SpawnNewInstance }
852 #- { key: F, mods: Command|Control, action: ToggleFullscreen }
853 #- { key: F, mods: Command, mode: ~Search, action: SearchForward }
854 #- { key: B, mods: Command, mode: ~Search, action: SearchBackward }
857 # Display the time it takes to redraw each frame.
860 # Keep the log file after quitting Alacritty.
861 #persistent_logging: false
865 # Values for `log_level`:
874 # Print all received window events.