· 6 years ago · Oct 02, 2019, 04:28 PM
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
15window:
16 # Window dimensions (changes require restart)
17 #
18 # Specified in number of columns/lines, not pixels.
19 # If both are `0`, this setting is ignored.
20 dimensions:
21 columns: 0
22 lines: 0
23
24 # Window padding (changes require restart)
25 #
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.
28 padding:
29 x: 2
30 y: 2
31
32 # Spread additional padding evenly around the terminal content.
33 dynamic_padding: false
34
35 # Window decorations
36 #
37 # Values for `decorations`:
38 # - full: Borders and title bar
39 # - none: Neither borders nor title bar
40 #
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
44 decorations: full
45
46 # When true, alacritty starts maximized.
47 startup_mode: Windowed
48
49scrolling:
50 # Maximum number of lines in the scrollback buffer.
51 # Specifying '0' will disable scrolling.
52 history: 10000
53
54 # Number of lines the viewport will move for every line scrolled when
55 # scrollback is enabled (history > 0).
56 multiplier: 3
57
58 # Faux Scrolling
59 #
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`.
63 #
64 # Specifying `0` will disable faux scrolling.
65 faux_multiplier: 3
66
67 # Scroll to the bottom when new text is written to the terminal.
68 auto_scroll: false
69
70# Spaces per Tab (changes require restart)
71#
72# This setting defines the width of a tab in cells.
73#
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.
77tabspaces: 8
78
79# Font configuration (changes require restart)
80font:
81 # Normal (roman) font face
82 #normal:
83 # Font family
84 #
85 # Default:
86 # - (macOS) Menlo
87 # - (Linux) monospace
88 # - (Windows) Consolas
89 #family: monospace
90
91 # The `style` can be specified to pick a specific face.
92 #style: Regular
93
94 # Bold font face
95 #bold:
96 # Font family
97 #
98 # If the bold family is not specified, it will fall back to the
99 # value specified for the normal font.
100 #family: monospace
101
102 # The `style` can be specified to pick a specific face.
103 #style: Bold
104
105 # Italic font face
106 #italic:
107 # Font family
108 #
109 # If the italic family is not specified, it will fall back to the
110 # value specified for the normal font.
111 #family: monospace
112
113 # The `style` can be specified to pick a specific face.
114 #style: Italic
115
116 # Point size
117 size: 9.5
118
119 # Offset is the extra space around each character. `offset.y` can be thought of
120 # as modifying the line spacing, and `offset.x` as modifying the letter spacing.
121 offset:
122 x: 0
123 y: 0
124
125 # Glyph offset determines the locations of the glyphs within their cells with
126 # the default being at the bottom. Increasing `x` moves the glyph to the right,
127 # increasing `y` moves the glyph upwards.
128 glyph_offset:
129 x: 0
130 y: 0
131
132 # Thin stroke font rendering (macOS only)
133 #
134 # Thin strokes are suitable for retina displays, but for non-retina screens
135 # it is recommended to set `use_thin_strokes` to `false`
136 #
137 # macOS >= 10.14.x:
138 #
139 # If the font quality on non-retina display looks bad then set
140 # `use_thin_strokes` to `true` and enable font smoothing by running the
141 # following command:
142 # `defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO`
143 #
144 # This is a global setting and will require a log out or restart to take
145 # effect.
146 use_thin_strokes: true
147
148# Keep the log file after quitting Alacritty.
149
150# If `true`, bold text is drawn using the bright color variants.
151draw_bold_text_with_bright_colors: true
152
153# Colors (Tomorrow Night Bright)
154colors:
155 primary:
156 background: '0x2E3440'
157 foreground: '0xD8DEE9'
158 cursor:
159 text: '0x2E3440'
160 cursor: '0xD8DEE9'
161 normal:
162 black: '0x3B4252'
163 red: '0xBF616A'
164 green: '0xA3BE8C'
165 yellow: '0xEBCB8B'
166 blue: '0x81A1C1'
167 magenta: '0xB48EAD'
168 cyan: '0x88C0D0'
169 white: '0xE5E9F0'
170 bright:
171 black: '0x4C566A'
172 red: '0xBF616A'
173 green: '0xA3BE8C'
174 yellow: '0xEBCB8B'
175 blue: '0x81A1C1'
176 magenta: '0xB48EAD'
177 cyan: '0x8FBCBB'
178 white: '0xECEFF4'
179
180 # Default colors
181 # primary:
182 # background: '0x000000'
183 # foreground: '0xeaeaea'
184
185 # Bright and dim foreground colors
186 #
187 # The dimmed foreground color is calculated automatically if it is not present.
188 # If the bright foreground color is not set, or `draw_bold_text_with_bright_colors`
189 # is `false`, the normal foreground color will be used.
190 #dim_foreground: '0x9a9a9a'
191 #bright_foreground: '0xffffff'
192
193 # Cursor colors
194 #
195 # Colors which should be used to draw the terminal cursor. If these are unset,
196 # the cursor color will be the inverse of the cell color.
197 #cursor:
198 # text: '0x000000'
199 # cursor: '0xffffff'
200
201 # Normal colors
202 # normal:
203 # black: '0x000000'
204 # red: '0xd54e53'
205 # green: '0xb9ca4a'
206 # yellow: '0xe6c547'
207 # blue: '0x7aa6da'
208 # magenta: '0xc397d8'
209 # cyan: '0x70c0ba'
210 # white: '0xeaeaea'
211
212 # Bright colors
213 # bright:
214 # black: '0x666666'
215 # red: '0xff3334'
216 # green: '0x9ec400'
217 # yellow: '0xe7c547'
218 # blue: '0x7aa6da'
219 # magenta: '0xb77ee0'
220 # cyan: '0x54ced6'
221 # white: '0xffffff'
222
223 # Dim colors
224 #
225 # If the dim colors are not set, they will be calculated automatically based
226 # on the `normal` colors.
227 #dim:
228 # black: '0x000000'
229 # red: '0x8c3336'
230 # green: '0x7a8530'
231 # yellow: '0x97822e'
232 # blue: '0x506d8f'
233 # magenta: '0x80638e'
234 # cyan: '0x497e7a'
235 # white: '0x9a9a9a'
236
237 # Indexed Colors
238 #
239 # The indexed colors include all colors from 16 to 256.
240 # When these are not set, they're filled with sensible defaults.
241 #
242 # Example:
243 # `- { index: 16, color: '0xff00ff' }`
244 #
245 indexed_colors: []
246
247# Visual Bell
248#
249# Any time the BEL code is received, Alacritty "rings" the visual bell. Once
250# rung, the terminal background will be set to white and transition back to the
251# default background color. You can control the rate of this transition by
252# setting the `duration` property (represented in milliseconds). You can also
253# configure the transition function by setting the `animation` property.
254#
255# Values for `animation`:
256# - Ease
257# - EaseOut
258# - EaseOutSine
259# - EaseOutQuad
260# - EaseOutCubic
261# - EaseOutQuart
262# - EaseOutQuint
263# - EaseOutExpo
264# - EaseOutCirc
265# - Linear
266#
267# Specifying a `duration` of `0` will disable the visual bell.
268visual_bell:
269 animation: EaseOutExpo
270 duration: 0
271 color: '0xffffff'
272
273# Background opacity
274#
275# Window opacity as a floating point number from `0.0` to `1.0`.
276# The value `0.0` is completely transparent and `1.0` is opaque.
277background_opacity: 1.0
278
279# Mouse bindings
280#
281# Available fields:
282# - mouse
283# - action
284# - mods (optional)
285#
286# Values for `mouse`:
287# - Middle
288# - Left
289# - Right
290# - Numeric identifier such as `5`
291#
292# All available `mods` and `action` values are documented in the key binding
293# section.
294mouse_bindings:
295 - { mouse: Middle, action: PasteSelection }
296
297mouse:
298 # Click settings
299 #
300 # The `double_click` and `triple_click` settings control the time
301 # alacritty should wait for accepting multiple clicks as one double
302 # or triple click.
303 double_click: { threshold: 300 }
304 triple_click: { threshold: 300 }
305
306 # If this is `true`, the cursor is temporarily hidden when typing.
307 hide_when_typing: false
308
309 url:
310 # URL launcher
311 #
312 # This program is executed when clicking on a text which is recognized as a URL.
313 # The URL is always added to the command as the last parameter.
314 #
315 # When set to `None`, URL launching will be disabled completely.
316 #
317 # Default:
318 # - (macOS) open
319 # - (Linux) xdg-open
320 # - (Windows) explorer
321 #launcher: xdg-open
322
323 # URL modifiers
324 #
325 # These are the modifiers that need to be held down for opening URLs when clicking
326 # on them. The available modifiers are documented in the key binding section.
327 modifiers: None
328
329selection:
330 semantic_escape_chars: ",│`|:\"' ()[]{}<>"
331
332 # When set to `true`, selected text will be copied to the primary clipboard.
333 save_to_clipboard: false
334
335# Allow terminal applications to change Alacritty's window title.
336dynamic_title: true
337
338cursor:
339 # Cursor style
340 #
341 # Values for `style`:
342 # - ▇ Block
343 # - _ Underline
344 # - | Beam
345 style: Block
346
347 # If this is `true`, the cursor will be rendered as a hollow box when the
348 # window is not focused.
349 unfocused_hollow: true
350
351# Live config reload (changes require restart)
352live_config_reload: true
353
354# Shell
355#
356# You can set `shell.program` to the path of your favorite shell, e.g. `/bin/fish`.
357# Entries in `shell.args` are passed unmodified as arguments to the shell.
358#
359# Default:
360# - (Linux/macOS) /bin/bash --login
361# - (Windows) powershell
362#shell:
363# program: /bin/bash
364# args:
365# - --login
366
367# Windows 10 ConPTY backend (Windows only)
368#
369# This will enable better color support and may resolve other issues,
370# however this API and its implementation is still young and so is
371# disabled by default, as stability may not be as good as the winpty
372# backend.
373#
374# Alacritty will fall back to the WinPTY automatically if the ConPTY
375# backend cannot be initialized.
376enable_experimental_conpty_backend: false
377
378# Send ESC (\x1b) before characters when alt is pressed.
379alt_send_esc: true
380debug:
381 # Display the time it takes to redraw each frame.
382 render_timer: false
383 persistent_logging: false
384
385# Key bindings
386#
387# Key bindings are specified as a list of objects. Each binding will specify a
388# key and modifiers required to trigger it, terminal modes where the binding is
389# applicable, and what should be done when the key binding fires. It can either
390# send a byte sequence to the running application (`chars`), execute a
391# predefined action (`action`) or fork and execute a specified command plus
392# arguments (`command`).
393#
394# Bindings are always filled by default, but will be replaced when a new binding
395# with the same triggers is defined. To unset a default binding, it can be
396# mapped to the `None` action.
397#
398# Example:
399# `- { key: V, mods: Control|Shift, action: Paste }`
400#
401# Available fields:
402# - key
403# - mods (optional)
404# - chars | action | command (exactly one required)
405# - mode (optional)
406#
407# Values for `key`:
408# - `A` -> `Z`
409# - `F1` -> `F12`
410# - `Key1` -> `Key0`
411#
412# A full list with available key codes can be found here:
413# https://docs.rs/glutin/*/glutin/enum.VirtualKeyCode.html#variants
414#
415# Instead of using the name of the keys, the `key` field also supports using
416# the scancode of the desired key. Scancodes have to be specified as a
417# decimal number.
418# This command will allow you to display the hex scancodes for certain keys:
419# `showkey --scancodes`
420#
421# Values for `mods`:
422# - Command
423# - Control
424# - Super
425# - Shift
426# - Alt
427#
428# Multiple `mods` can be combined using `|` like this: `mods: Control|Shift`.
429# Whitespace and capitalization is relevant and must match the example.
430#
431# Values for `chars`:
432# The `chars` field writes the specified string to the terminal. This makes
433# it possible to pass escape sequences.
434# To find escape codes for bindings like `PageUp` ("\x1b[5~"), you can run
435# the command `showkey -a` outside of tmux.
436# Note that applications use terminfo to map escape sequences back to
437# keys. It is therefore required to update the terminfo when
438# changing an escape sequence.
439#
440# Values for `action`:
441# - Paste
442# - PasteSelection
443# - Copy
444# - IncreaseFontSize
445# - DecreaseFontSize
446# - ResetFontSize
447# - ScrollPageUp
448# - ScrollPageDown
449# - ScrollToTop
450# - ScrollToBottom
451# - ClearHistory
452# - Hide
453# - Quit
454# - ClearLogNotice
455# - SpawnNewInstance
456# - None
457#
458# Values for `command`:
459# The `command` field must be a map containing a `program` string and
460# an `args` array of command line parameter strings.
461#
462# Example:
463# `command: { program: "alacritty", args: ["-e", "vttest"] }`
464#
465# Values for `mode`:
466# - ~AppCursor
467# - AppCursor
468# - ~AppKeypad
469# - AppKeypad
470key_bindings:
471 # (Windows/Linux only)
472 #- { key: V, mods: Control|Shift, action: Paste }
473 #- { key: C, mods: Control|Shift, action: Copy }
474 #- { key: Insert, mods: Shift, action: PasteSelection }
475 #- { key: Key0, mods: Control, action: ResetFontSize }
476 #- { key: Equals, mods: Control, action: IncreaseFontSize }
477 #- { key: Subtract, mods: Control, action: DecreaseFontSize }
478
479 # (macOS only)
480 #- { key: Key0, mods: Command, action: ResetFontSize }
481 #- { key: Equals, mods: Command, action: IncreaseFontSize }
482 #- { key: Minus, mods: Command, action: DecreaseFontSize }
483 #- { key: K, mods: Command, action: ClearHistory }
484 #- { key: K, mods: Command, chars: "\x0c" }
485 #- { key: V, mods: Command, action: Paste }
486 #- { key: C, mods: Command, action: Copy }
487 #- { key: H, mods: Command, action: Hide }
488 #- { key: Q, mods: Command, action: Quit }
489 #- { key: W, mods: Command, action: Quit }
490
491 - { key: Paste, action: Paste }
492 - { key: Copy, action: Copy }
493 - { key: L, mods: Control, action: ClearLogNotice }
494 - { key: L, mods: Control, chars: "\x0c" }
495 - { key: Home, chars: "\x1bOH", mode: AppCursor }
496 - { key: Home, chars: "\x1b[H", mode: ~AppCursor }
497 - { key: End, chars: "\x1bOF", mode: AppCursor }
498 - { key: End, chars: "\x1b[F", mode: ~AppCursor }
499 - { key: PageUp, mods: Shift, action: ScrollPageUp, mode: ~Alt }
500 - { key: PageUp, mods: Shift, chars: "\x1b[5;2~", mode: Alt }
501 - { key: PageUp, mods: Control, chars: "\x1b[5;5~" }
502 - { key: PageUp, chars: "\x1b[5~" }
503 - { key: PageDown, mods: Shift, action: ScrollPageDown, mode: ~Alt }
504 - { key: PageDown, mods: Shift, chars: "\x1b[6;2~", mode: Alt }
505 - { key: PageDown, mods: Control, chars: "\x1b[6;5~" }
506 - { key: PageDown, chars: "\x1b[6~" }
507 - { key: Tab, mods: Shift, chars: "\x1b[Z" }
508 - { key: Back, chars: "\x7f" }
509 - { key: Back, mods: Alt, chars: "\x1b\x7f" }
510 - { key: Insert, chars: "\x1b[2~" }
511 - { key: Delete, chars: "\x1b[3~" }
512 - { key: Left, mods: Shift, chars: "\x1b[1;2D" }
513 - { key: Left, mods: Control, chars: "\x1b[1;5D" }
514 - { key: Left, mods: Alt, chars: "\x1b[1;3D" }
515 - { key: Left, chars: "\x1b[D", mode: ~AppCursor }
516 - { key: Left, chars: "\x1bOD", mode: AppCursor }
517 - { key: Right, mods: Shift, chars: "\x1b[1;2C" }
518 - { key: Right, mods: Control, chars: "\x1b[1;5C" }
519 - { key: Right, mods: Alt, chars: "\x1b[1;3C" }
520 - { key: Right, chars: "\x1b[C", mode: ~AppCursor }
521 - { key: Right, chars: "\x1bOC", mode: AppCursor }
522 - { key: Up, mods: Shift, chars: "\x1b[1;2A" }
523 - { key: Up, mods: Control, chars: "\x1b[1;5A" }
524 - { key: Up, mods: Alt, chars: "\x1b[1;3A" }
525 - { key: Up, chars: "\x1b[A", mode: ~AppCursor }
526 - { key: Up, chars: "\x1bOA", mode: AppCursor }
527 - { key: Down, mods: Shift, chars: "\x1b[1;2B" }
528 - { key: Down, mods: Control, chars: "\x1b[1;5B" }
529 - { key: Down, mods: Alt, chars: "\x1b[1;3B" }
530 - { key: Down, chars: "\x1b[B", mode: ~AppCursor }
531 - { key: Down, chars: "\x1bOB", mode: AppCursor }
532 - { key: F1, chars: "\x1bOP" }
533 - { key: F2, chars: "\x1bOQ" }
534 - { key: F3, chars: "\x1bOR" }
535 - { key: F4, chars: "\x1bOS" }
536 - { key: F5, chars: "\x1b[15~" }
537 - { key: F6, chars: "\x1b[17~" }
538 - { key: F7, chars: "\x1b[18~" }
539 - { key: F8, chars: "\x1b[19~" }
540 - { key: F9, chars: "\x1b[20~" }
541 - { key: F10, chars: "\x1b[21~" }
542 - { key: F11, chars: "\x1b[23~" }
543 - { key: F12, chars: "\x1b[24~" }
544 - { key: F1, mods: Shift, chars: "\x1b[1;2P" }
545 - { key: F2, mods: Shift, chars: "\x1b[1;2Q" }
546 - { key: F3, mods: Shift, chars: "\x1b[1;2R" }
547 - { key: F4, mods: Shift, chars: "\x1b[1;2S" }
548 - { key: F5, mods: Shift, chars: "\x1b[15;2~" }
549 - { key: F6, mods: Shift, chars: "\x1b[17;2~" }
550 - { key: F7, mods: Shift, chars: "\x1b[18;2~" }
551 - { key: F8, mods: Shift, chars: "\x1b[19;2~" }
552 - { key: F9, mods: Shift, chars: "\x1b[20;2~" }
553 - { key: F10, mods: Shift, chars: "\x1b[21;2~" }
554 - { key: F11, mods: Shift, chars: "\x1b[23;2~" }
555 - { key: F12, mods: Shift, chars: "\x1b[24;2~" }
556 - { key: F1, mods: Control, chars: "\x1b[1;5P" }
557 - { key: F2, mods: Control, chars: "\x1b[1;5Q" }
558 - { key: F3, mods: Control, chars: "\x1b[1;5R" }
559 - { key: F4, mods: Control, chars: "\x1b[1;5S" }
560 - { key: F5, mods: Control, chars: "\x1b[15;5~" }
561 - { key: F6, mods: Control, chars: "\x1b[17;5~" }
562 - { key: F7, mods: Control, chars: "\x1b[18;5~" }
563 - { key: F8, mods: Control, chars: "\x1b[19;5~" }
564 - { key: F9, mods: Control, chars: "\x1b[20;5~" }
565 - { key: F10, mods: Control, chars: "\x1b[21;5~" }
566 - { key: F11, mods: Control, chars: "\x1b[23;5~" }
567 - { key: F12, mods: Control, chars: "\x1b[24;5~" }
568 - { key: F1, mods: Alt, chars: "\x1b[1;6P" }
569 - { key: F2, mods: Alt, chars: "\x1b[1;6Q" }
570 - { key: F3, mods: Alt, chars: "\x1b[1;6R" }
571 - { key: F4, mods: Alt, chars: "\x1b[1;6S" }
572 - { key: F5, mods: Alt, chars: "\x1b[15;6~" }
573 - { key: F6, mods: Alt, chars: "\x1b[17;6~" }
574 - { key: F7, mods: Alt, chars: "\x1b[18;6~" }
575 - { key: F8, mods: Alt, chars: "\x1b[19;6~" }
576 - { key: F9, mods: Alt, chars: "\x1b[20;6~" }
577 - { key: F10, mods: Alt, chars: "\x1b[21;6~" }
578 - { key: F11, mods: Alt, chars: "\x1b[23;6~" }
579 - { key: F12, mods: Alt, chars: "\x1b[24;6~" }
580 - { key: F1, mods: Super, chars: "\x1b[1;3P" }
581 - { key: F2, mods: Super, chars: "\x1b[1;3Q" }
582 - { key: F3, mods: Super, chars: "\x1b[1;3R" }
583 - { key: F4, mods: Super, chars: "\x1b[1;3S" }
584 - { key: F5, mods: Super, chars: "\x1b[15;3~" }
585 - { key: F6, mods: Super, chars: "\x1b[17;3~" }
586 - { key: F7, mods: Super, chars: "\x1b[18;3~" }
587 - { key: F8, mods: Super, chars: "\x1b[19;3~" }
588 - { key: F9, mods: Super, chars: "\x1b[20;3~" }
589 - { key: F10, mods: Super, chars: "\x1b[21;3~" }
590 - { key: F11, mods: Super, chars: "\x1b[23;3~" }
591 - { key: F12, mods: Super, chars: "\x1b[24;3~" }
592 - { key: NumpadEnter, chars: "\n" }