summaryrefslogtreecommitdiff
path: root/alacritty.yml
diff options
context:
space:
mode:
Diffstat (limited to 'alacritty.yml')
-rw-r--r--alacritty.yml176
1 files changed, 120 insertions, 56 deletions
diff --git a/alacritty.yml b/alacritty.yml
index 8e3dd220..50d36b42 100644
--- a/alacritty.yml
+++ b/alacritty.yml
@@ -8,8 +8,8 @@
#
# This value is used to set the `$TERM` environment variable for
# each instance of Alacritty. If it is not present, alacritty will
- # check the local terminfo database and use 'alacritty' if it is
- # available, otherwise 'xterm-256color' is used.
+ # check the local terminfo database and use `alacritty` if it is
+ # available, otherwise `xterm-256color` is used.
#TERM: xterm-256color
window:
@@ -18,8 +18,8 @@ window:
# Specified in number of columns/lines, not pixels.
# If both are `0`, this setting is ignored.
dimensions:
- columns: 80
- lines: 24
+ columns: 0
+ lines: 0
# Window padding (changes require restart)
#
@@ -37,6 +37,10 @@ window:
# Values for `decorations`:
# - full: Borders and title bar
# - none: Neither borders nor title bar
+ #
+ # Values for `decorations` (macOS only):
+ # - buttonless: Title bar, transparent background and title bar buttons
+ # - transparent: Title bar, transparent background, but no title bar buttons
decorations: full
# When true, alacritty starts maximized.
@@ -73,40 +77,41 @@ scrolling:
tabspaces: 8
# Font configuration (changes require restart)
-#
-# Important font attributes like antialiasing, subpixel aa, and hinting can be
-# controlled through fontconfig. Specifically, the following attributes should
-# have an effect:
-# - hintstyle
-# - antialias
-# - lcdfilter
-# - rgba
-#
-# For instance, if you wish to disable subpixel antialiasing, you might set the
-# rgba property to `none`. If you wish to completely disable antialiasing, you
-# can set antialias to `false`.
-#
-# Please see these resources for more information on how to use fontconfig:
-# - https://wiki.archlinux.org/index.php/font_configuration#Fontconfig_configuration
-# - file:///usr/share/doc/fontconfig/fontconfig-user.html
font:
# Normal (roman) font face
normal:
- family: monospace
+ # Font family
+ #
+ # Default:
+ # - (macOS) Menlo
+ # - (Linux) monospace
+ # - (Windows) Consolas
+ #family: monospace
+
# The `style` can be specified to pick a specific face.
- #style: Regular
+ style: Regular
# Bold font face
bold:
- family: monospace
+ # Font family
+ #
+ # If the bold family is not specified, it will fall back to the
+ # value specified for the normal font.
+ #family: monospace
+
# The `style` can be specified to pick a specific face.
- #style: Bold
+ style: Bold
# Italic font face
italic:
- family: monospace
+ # Font family
+ #
+ # If the italic family is not specified, it will fall back to the
+ # value specified for the normal font.
+ #family: monospace
+
# The `style` can be specified to pick a specific face.
- #style: Italic
+ style: Italic
# Point size
size: 11.0
@@ -124,6 +129,22 @@ font:
x: 0
y: 0
+ # Thin stroke font rendering (macOS only)
+ #
+ # Thin strokes are suitable for retina displays, but for non-retina screens
+ # it is recommended to set `use_thin_strokes` to `false`
+ #
+ # macOS >= 10.14.x:
+ #
+ # If the font quality on non-retina display looks bad then set
+ # `use_thin_strokes` to `true` and enable font smoothing by running the
+ # following command:
+ # `defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO`
+ #
+ # This is a global setting and will require a log out or restart to take
+ # effect.
+ use_thin_strokes: true
+
# Display the time it takes to redraw each frame.
render_timer: false
@@ -165,7 +186,7 @@ colors:
blue: '0x7aa6da'
magenta: '0xc397d8'
cyan: '0x70c0ba'
- white: '0xffffff'
+ white: '0xeaeaea'
# Bright colors
bright:
@@ -182,22 +203,25 @@ colors:
#
# If the dim colors are not set, they will be calculated automatically based
# on the `normal` colors.
- dim:
- black: '0x333333'
- red: '0xf2777a'
- green: '0x99cc99'
- yellow: '0xffcc66'
- blue: '0x6699cc'
- magenta: '0xcc99cc'
- cyan: '0x66cccc'
- white: '0xdddddd'
+ #dim:
+ # black: '0x000000'
+ # red: '0x8c3336'
+ # green: '0x7a8530'
+ # yellow: '0x97822e'
+ # blue: '0x506d8f'
+ # magenta: '0x80638e'
+ # cyan: '0x497e7a'
+ # white: '0x9a9a9a'
# Indexed Colors
#
# The indexed colors include all colors from 16 to 256.
# When these are not set, they're filled with sensible defaults.
- #indexed_colors:
- # - { index: 16, color: '0x000000' }
+ #
+ # Example:
+ # `- { index: 16, color: '0xff00ff' }`
+ #
+ indexed_colors: []
# Visual Bell
#
@@ -266,28 +290,32 @@ mouse:
#
# This program is executed when clicking on a text which is recognized as a URL.
# The URL is always added to the command as the last parameter.
- launcher: xdg-open
+ #
+ # Default:
+ # - (macOS) open
+ # - (Linux) xdg-open
+ # - (Windows) explorer
+ #launcher: xdg-open
# URL modifiers
#
# These are the modifiers that need to be held down for opening URLs when clicking
# on them. The available modifiers are documented in the key binding section.
- #modifiers: Control|Shift
+ modifiers: None
selection:
semantic_escape_chars: ",│`|:\"' ()[]{}<>"
- # When set to `true`, selected text will be copied to both the primary and
- # the selection clipboard. Otherwise, it will only be copied to the selection
- # clipboard.
+ # When set to `true`, selected text will be copied to the primary clipboard.
save_to_clipboard: false
+# Allow terminal applications to change Alacritty's window title.
dynamic_title: true
cursor:
# Cursor style
#
- # Values for 'style':
+ # Values for `style`:
# - ▇ Block
# - _ Underline
# - | Beam
@@ -304,20 +332,39 @@ live_config_reload: true
#
# You can set `shell.program` to the path of your favorite shell, e.g. `/bin/fish`.
# Entries in `shell.args` are passed unmodified as arguments to the shell.
+#
+# Default:
+# - (Linux/macOS) /bin/bash --login
+# - (Windows) powershell
#shell:
# program: /bin/bash
# args:
# - --login
+# Windows 10 ConPTY backend (Windows only)
+#
+# This will enable better color support and may resolve other issues,
+# however this API and its implementation is still young and so is
+# disabled by default, as stability may not be as good as the winpty
+# backend.
+#
+# Alacritty will fall back to the WinPTY automatically if the ConPTY
+# backend cannot be initialized.
+enable_experimental_conpty_backend: false
+
# Key bindings
#
-# Key bindings are specified as a list of objects. Each binding will specify
-# a key and modifiers required to trigger it, terminal modes where the binding
-# is applicable, and what should be done when the key binding fires. It can
-# either send a byte sequence to the running application (`chars`), execute
-# a predefined action (`action`) or fork and execute a specified command plus
+# Key bindings are specified as a list of objects. Each binding will specify a
+# key and modifiers required to trigger it, terminal modes where the binding is
+# applicable, and what should be done when the key binding fires. It can either
+# send a byte sequence to the running application (`chars`), execute a
+# predefined action (`action`) or fork and execute a specified command plus
# arguments (`command`).
#
+# Bindings are always filled by default, but will be replaced when a new binding
+# with the same triggers is defined. To unset a default binding, it can be
+# mapped to the `None` action.
+#
# Example:
# `- { key: V, mods: Control|Shift, action: Paste }`
#
@@ -342,8 +389,9 @@ live_config_reload: true
# `showkey --scancodes`
#
# Values for `mods`:
-# - Super
+# - Command
# - Control
+# - Super
# - Shift
# - Alt
#
@@ -375,6 +423,7 @@ live_config_reload: true
# - Quit
# - ClearLogNotice
# - SpawnNewInstance
+# - None
#
# Values for `command`:
# The `command` field must be a map containing a `program` string and
@@ -389,14 +438,28 @@ live_config_reload: true
# - ~AppKeypad
# - AppKeypad
key_bindings:
- - { key: V, mods: Control|Shift, action: Paste }
- - { key: C, mods: Control|Shift, action: Copy }
+ # (Windows/Linux only)
+ #- { key: V, mods: Control|Shift, action: Paste }
+ #- { key: C, mods: Control|Shift, action: Copy }
+ #- { key: Insert, mods: Shift, action: PasteSelection }
+ #- { key: Key0, mods: Control, action: ResetFontSize }
+ #- { key: Equals, mods: Control, action: IncreaseFontSize }
+ #- { key: Subtract, mods: Control, action: DecreaseFontSize }
+
+ # (macOS only)
+ #- { key: Key0, mods: Command, action: ResetFontSize }
+ #- { key: Equals, mods: Command, action: IncreaseFontSize }
+ #- { key: Minus, mods: Command, action: DecreaseFontSize }
+ #- { key: K, mods: Command, action: ClearHistory }
+ #- { key: K, mods: Command, chars: "\x0c" }
+ #- { key: V, mods: Command, action: Paste }
+ #- { key: C, mods: Command, action: Copy }
+ #- { key: H, mods: Command, action: Hide }
+ #- { key: Q, mods: Command, action: Quit }
+ #- { key: W, mods: Command, action: Quit }
+
- { key: Paste, action: Paste }
- { key: Copy, action: Copy }
- - { key: Insert, mods: Shift, action: PasteSelection }
- - { key: Key0, mods: Control, action: ResetFontSize }
- - { key: Equals, mods: Control, action: IncreaseFontSize }
- - { key: Subtract, mods: Control, action: DecreaseFontSize }
- { key: L, mods: Control, action: ClearLogNotice }
- { key: L, mods: Control, chars: "\x0c" }
- { key: Home, chars: "\x1bOH", mode: AppCursor }
@@ -494,3 +557,4 @@ key_bindings:
- { key: F10, mods: Super, chars: "\x1b[21;3~" }
- { key: F11, mods: Super, chars: "\x1b[23;3~" }
- { key: F12, mods: Super, chars: "\x1b[24;3~" }
+ - { key: NumpadEnter, chars: "\n" }