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