dotfiles

andersuno dotfiles
git clone git://git.andersuno.nu/dotfiles.git
Log | Files | Refs | README

alacritty.yml (18265B)


      1 # Configuration for Alacritty, the GPU enhanced terminal emulator.
      2 
      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.
      6 env:
      7   # TERM variable
      8   #
      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.
     13   TERM: xterm-256color
     14 
     15 window:
     16   # Window opacity
     17   #
     18   # Window opacity as a floating point number from `0.0` to `1.0`.
     19   # The value `0.0` is completely transparent and `1.0` is opaque.
     20   opacity: 0.7
     21 
     22   # Window dimensions (changes require restart)
     23   #
     24   # Specified in number of columns/lines, not pixels.
     25   # If both are `0`, this setting is ignored.
     26   #dimensions:
     27   #  columns: 0
     28   #  lines: 0
     29 
     30   # Window position (changes require restart)
     31   #
     32   # Specified in number of pixels.
     33   # If the position is not set, the window manager will handle the placement.
     34   #position:
     35   #  x: 0
     36   #  y: 0
     37 
     38   # Window padding (changes require restart)
     39   #
     40   # Blank space added around the window in pixels. This padding is scaled
     41   # by DPI and the specified value is always added at both opposing sides.
     42   #padding:
     43   #  x: 0
     44   #  y: 0
     45 
     46   # Spread additional padding evenly around the terminal content.
     47   #dynamic_padding: false
     48 
     49   # Window decorations
     50   #
     51   # Values for `decorations`:
     52   #     - full: Borders and title bar
     53   #     - none: Neither borders nor title bar
     54   #
     55   # Values for `decorations` (macOS only):
     56   #     - transparent: Title bar, transparent background and title bar buttons
     57   #     - buttonless: Title bar, transparent background, but no title bar buttons
     58   #decorations: full
     59 
     60   # Startup Mode (changes require restart)
     61   #
     62   # Values for `startup_mode`:
     63   #   - Windowed
     64   #   - Maximized
     65   #   - Fullscreen
     66   #
     67   # Values for `startup_mode` (macOS only):
     68   #   - SimpleFullscreen
     69   #startup_mode: Windowed
     70 
     71   # Window title
     72   #title: Alacritty
     73 
     74   # Window class (Linux/BSD only):
     75   #class:
     76     # Application instance name
     77     #instance: Alacritty
     78     # General application class
     79     #general: Alacritty
     80 
     81   # GTK theme variant (Linux/BSD only)
     82   #
     83   # Override the variant of the GTK theme. Commonly supported values are `dark` and `light`.
     84   # Set this to `None` to use the default theme variant.
     85   #gtk_theme_variant: None
     86 
     87 #scrolling:
     88   # Maximum number of lines in the scrollback buffer.
     89   # Specifying '0' will disable scrolling.
     90   #history: 10000
     91 
     92   # Number of lines the viewport will move for every line scrolled when
     93   # scrollback is enabled (history > 0).
     94   #multiplier: 3
     95 
     96 # Spaces per Tab (changes require restart)
     97 #
     98 # This setting defines the width of a tab in cells.
     99 #
    100 # Some applications, like Emacs, rely on knowing about the width of a tab.
    101 # To prevent unexpected behavior in these applications, it's also required to
    102 # change the `it` value in terminfo when altering this setting.
    103 #tabspaces: 8
    104 
    105 # Font configuration
    106 font:
    107   # Normal (roman) font face
    108   #normal:
    109     # Font family
    110     #
    111     # Default:
    112     #   - (macOS) Menlo
    113     #   - (Linux/BSD) monospace
    114     #   - (Windows) Consolas
    115     #family: monospace
    116 
    117     # The `style` can be specified to pick a specific face.
    118     #style: Regular
    119 
    120   # Bold font face
    121   #bold:
    122     # Font family
    123     #
    124     # If the bold family is not specified, it will fall back to the
    125     # value specified for the normal font.
    126     #family: monospace
    127 
    128     # The `style` can be specified to pick a specific face.
    129     #style: Bold
    130 
    131   # Italic font face
    132   #italic:
    133     # Font family
    134     #
    135     # If the italic family is not specified, it will fall back to the
    136     # value specified for the normal font.
    137     #family: monospace
    138 
    139     # The `style` can be specified to pick a specific face.
    140     #style: Italic
    141 
    142   # Bold italic font face
    143   #bold_italic:
    144     # Font family
    145     #
    146     # If the bold italic family is not specified, it will fall back to the
    147     # value specified for the normal font.
    148     #family: monospace
    149 
    150     # The `style` can be specified to pick a specific face.
    151     #style: Bold Italic
    152 
    153   # Point size
    154   size: 11.0
    155 
    156   # Offset is the extra space around each character. `offset.y` can be thought of
    157   # as modifying the line spacing, and `offset.x` as modifying the letter spacing.
    158   #offset:
    159   #  x: 0
    160   #  y: 0
    161 
    162   # Glyph offset determines the locations of the glyphs within their cells with
    163   # the default being at the bottom. Increasing `x` moves the glyph to the right,
    164   # increasing `y` moves the glyph upwards.
    165   #glyph_offset:
    166   #  x: 0
    167   #  y: 0
    168 
    169   # Thin stroke font rendering (macOS only)
    170   #
    171   # Thin strokes are suitable for retina displays, but for non-retina screens
    172   # it is recommended to set `use_thin_strokes` to `false`
    173   #
    174   # macOS >= 10.14.x:
    175   #
    176   # If the font quality on non-retina display looks bad then set
    177   # `use_thin_strokes` to `true` and enable font smoothing by running the
    178   # following command:
    179   #   `defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO`
    180   #
    181   # This is a global setting and will require a log out or restart to take
    182   # effect.
    183   #use_thin_strokes: true
    184 
    185 # If `true`, bold text is drawn using the bright color variants.
    186 #draw_bold_text_with_bright_colors: false
    187 
    188 # Colors (Tomorrow Night Bright)
    189 #colors:
    190   # Default colors
    191   #primary:
    192   #  background: '0x000000'
    193   #  foreground: '0xeaeaea'
    194 
    195     # Bright and dim foreground colors
    196     #
    197     # The dimmed foreground color is calculated automatically if it is not present.
    198     # If the bright foreground color is not set, or `draw_bold_text_with_bright_colors`
    199     # is `false`, the normal foreground color will be used.
    200     #dim_foreground: '0x9a9a9a'
    201     #bright_foreground: '0xffffff'
    202 
    203   # Cursor colors
    204   #
    205   # Colors which should be used to draw the terminal cursor. If these are unset,
    206   # the cursor color will be the inverse of the cell color.
    207   #cursor:
    208   #  text: '0x000000'
    209   #  cursor: '0xffffff'
    210 
    211   # Selection colors
    212   #
    213   # Colors which should be used to draw the selection area. If selection
    214   # background is unset, selection color will be the inverse of the cell colors.
    215   # If only text is unset the cell text color will remain the same.
    216   #selection:
    217   #  text: '0xeaeaea'
    218   #  background: '0x404040'
    219 
    220   # Normal colors
    221   #normal:
    222   #  black:   '0x000000'
    223   #  red:     '0xd54e53'
    224   #  green:   '0xb9ca4a'
    225   #  yellow:  '0xe6c547'
    226   #  blue:    '0x7aa6da'
    227   #  magenta: '0xc397d8'
    228   #  cyan:    '0x70c0ba'
    229   #  white:   '0xeaeaea'
    230 
    231   # Bright colors
    232   #bright:
    233   #  black:   '0x666666'
    234   #  red:     '0xff3334'
    235   #  green:   '0x9ec400'
    236   #  yellow:  '0xe7c547'
    237   #  blue:    '0x7aa6da'
    238   #  magenta: '0xb77ee0'
    239   #  cyan:    '0x54ced6'
    240   #  white:   '0xffffff'
    241 
    242   # Dim colors
    243   #
    244   # If the dim colors are not set, they will be calculated automatically based
    245   # on the `normal` colors.
    246   #dim:
    247   #  black:   '0x000000'
    248   #  red:     '0x8c3336'
    249   #  green:   '0x7a8530'
    250   #  yellow:  '0x97822e'
    251   #  blue:    '0x506d8f'
    252   #  magenta: '0x80638e'
    253   #  cyan:    '0x497e7a'
    254   #  white:   '0x9a9a9a'
    255 
    256   # Indexed Colors
    257   #
    258   # The indexed colors include all colors from 16 to 256.
    259   # When these are not set, they're filled with sensible defaults.
    260   #
    261   # Example:
    262   #   `- { index: 16, color: '0xff00ff' }`
    263   #
    264   #indexed_colors: []
    265 
    266 # Gnometerm colors
    267 colors:
    268   # Default colors
    269   primary:
    270     background: '0x000000'
    271     foreground: '0xffffff'
    272 
    273   # Normal colors
    274   normal:
    275     black:   '0x000000'
    276     red:     '0xcc0000'
    277     green:   '0x4e9a06'
    278     yellow:  '0xc4a000'
    279     blue:    '0x3465a4'
    280     magenta: '0x75507b'
    281     cyan:    '0x06989a'
    282     white:   '0xd3d7cf'
    283 
    284   # Bright colors
    285   bright:
    286     black:   '0x555753'
    287     red:     '0xef2929'
    288     green:   '0x8ae234'
    289     yellow:  '0xfce94f'
    290     blue:    '0x729fcf'
    291     magenta: '0xad7fa8'
    292     cyan:    '0x34e2e2'
    293     white:   '0xeeeeec'
    294 
    295 # XTerm's default colors
    296 #colors:
    297 #   # Default colors
    298 #   primary:
    299 #     background: '0x000000'
    300 #     foreground: '0xffffff'
    301 #   # Normal colors
    302 #   normal:
    303 #     black:   '0x000000'
    304 #     red:     '0xcd0000'
    305 #     green:   '0x00cd00'
    306 #     yellow:  '0xcdcd00'
    307 #     blue:    '0x0000ee'
    308 #     magenta: '0xcd00cd'
    309 #     cyan:    '0x00cdcd'
    310 #     white:   '0xe5e5e5'
    311 #
    312 #   # Bright colors
    313 #   bright:
    314 #     black:   '0x7f7f7f'
    315 #     red:     '0xff0000'
    316 #     green:   '0x00ff00'
    317 #     yellow:  '0xffff00'
    318 #     blue:    '0x5c5cff'
    319 #     magenta: '0xff00ff'
    320 #     cyan:    '0x00ffff'
    321 #     white:   '0xffffff'
    322 #
    323 # Visual Bell
    324 #
    325 # Any time the BEL code is received, Alacritty "rings" the visual bell. Once
    326 # rung, the terminal background will be set to white and transition back to the
    327 # default background color. You can control the rate of this transition by
    328 # setting the `duration` property (represented in milliseconds). You can also
    329 # configure the transition function by setting the `animation` property.
    330 #
    331 # Values for `animation`:
    332 #   - Ease
    333 #   - EaseOut
    334 #   - EaseOutSine
    335 #   - EaseOutQuad
    336 #   - EaseOutCubic
    337 #   - EaseOutQuart
    338 #   - EaseOutQuint
    339 #   - EaseOutExpo
    340 #   - EaseOutCirc
    341 #   - Linear
    342 #
    343 # Specifying a `duration` of `0` will disable the visual bell.
    344 #visual_bell:
    345 #  animation: EaseOutExpo
    346 #  duration: 0
    347 #  color: '0xffffff'
    348 
    349 # Background opacity
    350 #
    351 # Window opacity as a floating point number from `0.0` to `1.0`.
    352 # The value `0.0` is completely transparent and `1.0` is opaque.
    353 # moved to window
    354 
    355 #selection:
    356   #semantic_escape_chars: ",│`|:\"' ()[]{}<>\t"
    357 
    358   # When set to `true`, selected text will be copied to the primary clipboard.
    359   #save_to_clipboard: false
    360 
    361 # Allow terminal applications to change Alacritty's window title.
    362 #dynamic_title: true
    363 
    364 #cursor:
    365   # Cursor style
    366   #
    367   # Values for `style`:
    368   #   - ▇ Block
    369   #   - _ Underline
    370   #   - | Beam
    371   #style: Block
    372 
    373   # If this is `true`, the cursor will be rendered as a hollow box when the
    374   # window is not focused.
    375   #unfocused_hollow: true
    376 
    377 # Live config reload (changes require restart)
    378 #live_config_reload: true
    379 
    380 # Shell
    381 #
    382 # You can set `shell.program` to the path of your favorite shell, e.g. `/bin/fish`.
    383 # Entries in `shell.args` are passed unmodified as arguments to the shell.
    384 #
    385 # Default:
    386 #   - (macOS) /bin/bash --login
    387 #   - (Linux/BSD) user login shell
    388 #   - (Windows) powershell
    389 #shell:
    390 #  program: /bin/bash
    391 #  args:
    392 #    - --login
    393 
    394 # Startup directory
    395 #
    396 # Directory the shell is started in. If this is unset, or `None`, the working
    397 # directory of the parent process will be used.
    398 #working_directory: None
    399 
    400 # WinPTY backend (Windows only)
    401 #
    402 # Alacritty defaults to using the newer ConPTY backend if it is available,
    403 # since it resolves a lot of bugs and is quite a bit faster. If it is not
    404 # available, the the WinPTY backend will be used instead.
    405 #
    406 # Setting this option to `true` makes Alacritty use the legacy WinPTY backend,
    407 # even if the ConPTY backend is available.
    408 #winpty_backend: false
    409 
    410 # Send ESC (\x1b) before characters when alt is pressed.
    411 #alt_send_esc: true
    412 
    413 #debug:
    414   # Display the time it takes to redraw each frame.
    415   #render_timer: false
    416 
    417   # Keep the log file after quitting Alacritty.
    418   #persistent_logging: false
    419 
    420   # Log level
    421   #
    422   # Values for `log_level`:
    423   #   - None
    424   #   - Error
    425   #   - Warn
    426   #   - Info
    427   #   - Debug
    428   #   - Trace
    429   #log_level: Warn
    430 
    431   # Print all received window events.
    432   #print_events: false
    433 
    434   # Record all characters and escape sequences as test data.
    435   #ref_test: false
    436 
    437 #mouse:
    438   # Click settings
    439   #
    440   # The `double_click` and `triple_click` settings control the time
    441   # alacritty should wait for accepting multiple clicks as one double
    442   # or triple click.
    443   #double_click: { threshold: 300 }
    444   #triple_click: { threshold: 300 }
    445 
    446   # If this is `true`, the cursor is temporarily hidden when typing.
    447   #hide_when_typing: false
    448 
    449   #url:
    450     # URL launcher
    451     #
    452     # This program is executed when clicking on a text which is recognized as a URL.
    453     # The URL is always added to the command as the last parameter.
    454     #
    455     # When set to `None`, URL launching will be disabled completely.
    456     #
    457     # Default:
    458     #   - (macOS) open
    459     #   - (Linux/BSD) xdg-open
    460     #   - (Windows) explorer
    461     #launcher:
    462     #  program: xdg-open
    463     #  args: []
    464 
    465     # URL modifiers
    466     #
    467     # These are the modifiers that need to be held down for opening URLs when clicking
    468     # on them. The available modifiers are documented in the key binding section.
    469     #modifiers: None
    470 
    471 # Mouse bindings
    472 #
    473 # Mouse bindings are specified as a list of objects, much like the key
    474 # bindings further below.
    475 #
    476 # To trigger mouse bindings when an application running within Alacritty captures the mouse, the
    477 # `Shift` modifier is automatically added as a requirement.
    478 #
    479 # Each mouse binding will specify a:
    480 #
    481 # - `mouse`:
    482 #
    483 #   - Middle
    484 #   - Left
    485 #   - Right
    486 #   - Numeric identifier such as `5`
    487 #
    488 # - `action` (see key bindings)
    489 #
    490 # And optionally:
    491 #
    492 # - `mods` (see key bindings)
    493 #mouse_bindings:
    494 #  - { mouse: Middle, action: PasteSelection }
    495 
    496 # Key bindings
    497 #
    498 # Key bindings are specified as a list of objects. For example, this is the
    499 # default paste binding:
    500 #
    501 # `- { key: V, mods: Control|Shift, action: Paste }`
    502 #
    503 # Each key binding will specify a:
    504 #
    505 # - `key`: Identifier of the key pressed
    506 #
    507 #    - A-Z
    508 #    - F1-F24
    509 #    - Key0-Key9
    510 #
    511 #    A full list with available key codes can be found here:
    512 #    https://docs.rs/glutin/*/glutin/event/enum.VirtualKeyCode.html#variants
    513 #
    514 #    Instead of using the name of the keys, the `key` field also supports using
    515 #    the scancode of the desired key. Scancodes have to be specified as a
    516 #    decimal number. This command will allow you to display the hex scancodes
    517 #    for certain keys:
    518 #
    519 #       `showkey --scancodes`.
    520 #
    521 # Then exactly one of:
    522 #
    523 # - `chars`: Send a byte sequence to the running application
    524 #
    525 #    The `chars` field writes the specified string to the terminal. This makes
    526 #    it possible to pass escape sequences. To find escape codes for bindings
    527 #    like `PageUp` (`"\x1b[5~"`), you can run the command `showkey -a` outside
    528 #    of tmux. Note that applications use terminfo to map escape sequences back
    529 #    to keys. It is therefore required to update the terminfo when changing an
    530 #    escape sequence.
    531 #
    532 # - `action`: Execute a predefined action
    533 #
    534 #   - Copy
    535 #   - Paste
    536 #   - PasteSelection
    537 #   - IncreaseFontSize
    538 #   - DecreaseFontSize
    539 #   - ResetFontSize
    540 #   - ScrollPageUp
    541 #   - ScrollPageDown
    542 #   - ScrollLineUp
    543 #   - ScrollLineDown
    544 #   - ScrollToTop
    545 #   - ScrollToBottom
    546 #   - ClearHistory
    547 #   - Hide
    548 #   - Minimize
    549 #   - Quit
    550 #   - ToggleFullscreen
    551 #   - SpawnNewInstance
    552 #   - ClearLogNotice
    553 #   - ReceiveChar
    554 #   - None
    555 #
    556 #   (macOS only):
    557 #   - ToggleSimpleFullscreen: Enters fullscreen without occupying another space
    558 #
    559 # - `command`: Fork and execute a specified command plus arguments
    560 #
    561 #    The `command` field must be a map containing a `program` string and an
    562 #    `args` array of command line parameter strings. For example:
    563 #       `{ program: "alacritty", args: ["-e", "vttest"] }`
    564 #
    565 # And optionally:
    566 #
    567 # - `mods`: Key modifiers to filter binding actions
    568 #
    569 #    - Command
    570 #    - Control
    571 #    - Option
    572 #    - Super
    573 #    - Shift
    574 #    - Alt
    575 #
    576 #    Multiple `mods` can be combined using `|` like this:
    577 #       `mods: Control|Shift`.
    578 #    Whitespace and capitalization are relevant and must match the example.
    579 #
    580 # - `mode`: Indicate a binding for only specific terminal reported modes
    581 #
    582 #    This is mainly used to send applications the correct escape sequences
    583 #    when in different modes.
    584 #
    585 #    - AppCursor
    586 #    - AppKeypad
    587 #    - Alt
    588 #
    589 #    A `~` operator can be used before a mode to apply the binding whenever
    590 #    the mode is *not* active, e.g. `~Alt`.
    591 #
    592 # Bindings are always filled by default, but will be replaced when a new
    593 # binding with the same triggers is defined. To unset a default binding, it can
    594 # be mapped to the `ReceiveChar` action. Alternatively, you can use `None` for
    595 # a no-op if you do not wish to receive input characters for that binding.
    596 #key_bindings:
    597   # (Windows, Linux, and BSD only)
    598   #- { key: V,        mods: Control|Shift, action: Paste            }
    599   #- { key: C,        mods: Control|Shift, action: Copy             }
    600   #- { key: Insert,   mods: Shift,         action: PasteSelection   }
    601   #- { key: Key0,     mods: Control,       action: ResetFontSize    }
    602   #- { key: Equals,   mods: Control,       action: IncreaseFontSize }
    603   #- { key: Add,      mods: Control,       action: IncreaseFontSize }
    604   #- { key: Subtract, mods: Control,       action: DecreaseFontSize }
    605   #- { key: Minus,    mods: Control,       action: DecreaseFontSize }
    606 
    607   # (Windows only)
    608   #- { key: Return,   mods: Alt,           action: ToggleFullscreen }
    609 
    610   # (macOS only)
    611   #- { key: Key0,   mods: Command,         action: ResetFontSize    }
    612   #- { key: Equals, mods: Command,         action: IncreaseFontSize }
    613   #- { key: Add,    mods: Command,         action: IncreaseFontSize }
    614   #- { key: Minus,  mods: Command,         action: DecreaseFontSize }
    615   #- { key: K,      mods: Command,         action: ClearHistory     }
    616   #- { key: K,      mods: Command,         chars: "\x0c"            }
    617   #- { key: V,      mods: Command,         action: Paste            }
    618   #- { key: C,      mods: Command,         action: Copy             }
    619   #- { key: H,      mods: Command,         action: Hide             }
    620   #- { key: M,      mods: Command,         action: Minimize         }
    621   #- { key: Q,      mods: Command,         action: Quit             }
    622   #- { key: W,      mods: Command,         action: Quit             }
    623   #- { key: F,      mods: Command|Control, action: ToggleFullscreen }
    624 
    625   #- { key: Paste,                    action: Paste                            }
    626   #- { key: Copy,                     action: Copy                             }
    627   #- { key: L,         mods: Control, action: ClearLogNotice                   }
    628   #- { key: L,         mods: Control, chars: "\x0c"                            }
    629   #- { key: PageUp,    mods: Shift,   action: ScrollPageUp,   mode: ~Alt       }
    630   #- { key: PageDown,  mods: Shift,   action: ScrollPageDown, mode: ~Alt       }
    631   #- { key: Home,      mods: Shift,   action: ScrollToTop,    mode: ~Alt       }
    632   #- { key: End,       mods: Shift,   action: ScrollToBottom, mode: ~Alt       }