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