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 }