| # 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 |
| |
| #window: |
| # Window dimensions (changes require restart) |
| # |
| # Specified in number of columns/lines, not pixels. |
| # If both are `0`, this setting is ignored. |
| #dimensions: |
| # columns: 0 |
| # lines: 0 |
| |
| # 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 |
| # |
| # Values for `decorations` (macOS only): |
| # - transparent: Title bar, transparent background and title bar buttons |
| # - buttonless: Title bar, transparent background, but no title bar buttons |
| #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/BSD only): |
| #class: |
| # Application instance name |
| #instance: Alacritty |
| # General application class |
| #general: Alacritty |
| |
| # GTK theme variant (Linux/BSD 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 |
| |
| # 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 |
| #font: |
| # Normal (roman) font face |
| #normal: |
| # Font family |
| # |
| # Default: |
| # - (macOS) Menlo |
| # - (Linux/BSD) monospace |
| # - (Windows) Consolas |
| #family: monospace |
| |
| # The `style` can be specified to pick a specific face. |
| #style: Regular |
| |
| # Bold font face |
| #bold: |
| # Font family |
| # |
| # If the bold family is not specified, it will fall back to the |
| # value specified for the normal font. |
| #family: monospace |
| |
| # The `style` can be specified to pick a specific face. |
| #style: Bold |
| |
| # Italic font face |
| #italic: |
| # Font family |
| # |
| # If the italic family is not specified, it will fall back to the |
| # value specified for the normal font. |
| #family: monospace |
| |
| # The `style` can be specified to pick a specific face. |
| #style: Italic |
| |
| # Bold italic font face |
| #bold_italic: |
| # Font family |
| # |
| # If the bold italic family is not specified, it will fall back to the |
| # value specified for the normal font. |
| #family: monospace |
| |
| # The `style` can be specified to pick a specific face. |
| #style: Bold Italic |
| |
| # Point size |
| #size: 11.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 (Tomorrow Night Bright) |
| #colors: |
| # Default colors |
| #primary: |
| # background: '0x000000' |
| # foreground: '0xeaeaea' |
| |
| # 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: '0x9a9a9a' |
| #bright_foreground: '0xffffff' |
| |
| # 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: '0x000000' |
| # cursor: '0xffffff' |
| |
| # 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: '0xeaeaea' |
| # background: '0x404040' |
| |
| # Normal colors |
| #normal: |
| # black: '0x000000' |
| # red: '0xd54e53' |
| # green: '0xb9ca4a' |
| # yellow: '0xe6c547' |
| # blue: '0x7aa6da' |
| # magenta: '0xc397d8' |
| # cyan: '0x70c0ba' |
| # white: '0xeaeaea' |
| |
| # Bright colors |
| #bright: |
| # black: '0x666666' |
| # red: '0xff3334' |
| # green: '0x9ec400' |
| # yellow: '0xe7c547' |
| # blue: '0x7aa6da' |
| # magenta: '0xb77ee0' |
| # cyan: '0x54ced6' |
| # white: '0xffffff' |
| |
| # 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: '0xff00ff' }` |
| # |
| #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: |
| # animation: EaseOutExpo |
| # duration: 0 |
| # color: '0xffffff' |
| |
| # 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: 1.0 |
| |
| #selection: |
| #semantic_escape_chars: ",│`|:\"' ()[]{}<>\t" |
| |
| # When set to `true`, selected text will be copied to the primary clipboard. |
| #save_to_clipboard: false |
| |
| # Allow terminal applications to change Alacritty's window title. |
| #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/BSD) 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 |
| |
| # WinPTY backend (Windows only) |
| # |
| # Alacritty defaults to using the newer ConPTY backend if it is available, |
| # since it resolves a lot of bugs and is quite a bit faster. If it is not |
| # available, the the WinPTY backend will be used instead. |
| # |
| # Setting this option to `true` makes Alacritty use the legacy WinPTY backend, |
| # even if the ConPTY backend is available. |
| #winpty_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: false |
| |
| #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/BSD) xdg-open |
| # - (Windows) explorer |
| #launcher: |
| # program: xdg-open |
| # 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: None |
| |
| # Mouse bindings |
| # |
| # Mouse bindings are specified as a list of objects, much like the key |
| # bindings further below. |
| # |
| # To trigger mouse bindings when an application running within Alacritty captures the mouse, the |
| # `Shift` modifier is automatically added as a requirement. |
| # |
| # 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 |
| # - Minimize |
| # - 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: |
| # (Windows, Linux, and BSD only) |
| #- { key: V, mods: Control|Shift, action: Paste } |
| #- { key: C, mods: Control|Shift, 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 } |
| |
| # (Windows only) |
| #- { key: Return, mods: Alt, action: ToggleFullscreen } |
| |
| # (macOS only) |
| #- { key: Key0, mods: Command, action: ResetFontSize } |
| #- { key: Equals, mods: Command, action: IncreaseFontSize } |
| #- { key: Add, mods: Command, action: IncreaseFontSize } |
| #- { key: Minus, mods: Command, action: DecreaseFontSize } |
| #- { key: K, mods: Command, action: ClearHistory } |
| #- { key: K, mods: Command, chars: "\x0c" } |
| #- { key: V, mods: Command, action: Paste } |
| #- { key: C, mods: Command, action: Copy } |
| #- { key: H, mods: Command, action: Hide } |
| #- { key: M, mods: Command, action: Minimize } |
| #- { key: Q, mods: Command, action: Quit } |
| #- { key: W, mods: Command, action: Quit } |
| #- { key: F, mods: Command|Control, action: ToggleFullscreen } |
| |
| #- { key: Paste, action: Paste } |
| #- { key: Copy, action: Copy } |
| #- { key: L, mods: Control, action: ClearLogNotice } |
| #- { key: L, mods: Control, chars: "\x0c" } |
| #- { key: PageUp, mods: Shift, action: ScrollPageUp, mode: ~Alt } |
| #- { key: PageDown, mods: Shift, action: ScrollPageDown, mode: ~Alt } |
| #- { key: Home, mods: Shift, action: ScrollToTop, mode: ~Alt } |
| #- { key: End, mods: Shift, action: ScrollToBottom, mode: ~Alt } |