ALACRITTY(5) File Formats Manual ALACRITTY(5) (NAME) alacritty - TOML. (SYNTAX) Alacritty TOML . https://toml.io/en/v1.0.0 . (LOCATION) Alacritty : 1. $XDG_CONFIG_HOME/alacritty/alacritty.toml 2. $XDG_CONFIG_HOME/alacritty.toml 3. $HOME/.config/alacritty/alacritty.toml 4. $HOME/.alacritty.toml 5. /etc/alacritty/alacritty.toml : 1. %APPDATA%\alacritty\alacritty.toml (GENERAL) [general] . import = ["",] (Import) . . . / ~/ . : import = [ "~/.config/alacritty/base16-dark.toml", "~/.config/alacritty/keybindings.toml", "alacritty-theme/themes/gruvbox_dark.toml", ] working_directory = "" | "None" . "None" . : "None" live_config_reload = true | false ( ) : true ipc_socket = true | false # (unix only) IPC alacritty msg : true (ENV) - [env] Alacritty . alacritty . : [env] WINIT_X11_SCALE_FACTOR = "1.0" (WINDOW) [window] . dimensions = { columns = , lines = } ( ). / ( ) . . 2 0 : { columns = 0, lines = 0 } position = "None" | { x = , y = } # (has no effect on Wayland) . . "None" . : "None" padding = { x = , y = } (Padding) . DPI . : { x = 0, y = 0 } dynamic_padding = true | false . : false decorations = "Full" | "None" | "Transparent" | "Buttonless" (Decorations). Full . None . Transparent (macOS only) . Buttonless (macOS only) . : "Full" opacity = (Opacity) 0.0 1.0. 0.0 1.0 . : 1.0 blur = true | false # (works on macOS/KDE Wayland) (Compositor) / . : false startup_mode = "Windowed" | "Maximized" | "Fullscreen" | "SimpleFullscreen" ( ) Windowed . Maximized . Fullscreen . SimpleFullscreen (macOS only) Fullscreen . : "Windowed" title = "" . : "Alacritty" dynamic_title = true | false Alacritty. : true class = { instance = "", general = "" } # (Linux/BSD only) (Window Class). (Wayland) general app_id instance . : { instance = "Alacritty", general = "Alacritty" } decorations_theme_variant = "Dark" | "Light" | "None" / GTK / . "None" . : "None" resize_increments = true | false # (works on macOS/X11/Wayland) . : false option_as_alt = "OnlyLeft" | "OnlyRight" | "Both" | "None" # (macOS only) Option Alt. : "None" level = "Normal" | "AlwaysOnTop" (Window Level) . Normal z . AlwaysOnTop . : "Normal" : [window] padding = { x = 3, y = 3 } dynamic_padding = true opacity = 0.9 (SCROLLING) [scrolling] . history = (scrollback). 0 . 100000. : 10000 multiplier = (). : 3 (FONT) [font] . normal = { family = "", style = "" } : Linux/BSD: { family = "monospace", style = "Regular" } Windows: { family = "Consolas", style = "Regular" } macOS: { family = "Menlo", style = "Regular" } bold = { family = "", style = "" } (family) (normal) . : { style = "Bold" } italic = { family = "", style = "" } (family) (normal) . : { style = "Italic" } bold_italic = { family = "", style = "" } (family) (normal) . : { style = "Bold Italic" } size = (point). : 11.25 offset = { x = , y = } ( ) . y x . : { x = 0, y = 0 } glyph_offset = { x = , y = } (glyph offset) . x y . builtin_box_drawing = true | false true ( U+2500 U+259F) (U+1FB00 U+1FB3B) (U+E0B0 U+E0B3) . : true (COLORS) [colors] . # : #RRGGBB. primary [colors.primary] . foreground = "" : "#d8d8d8" background = "" : "#181818" dim_foreground = "" (foreground) . : "#828482" bright_foreground = "" draw_bold_text_with_bright_colors true . . : "None" cursor = { text = "", cursor = "" } . #ff00ff CellForeground/CellBackground . : { text = "CellBackground", cursor = "CellForeground" } vi_mode_cursor = { text = "", cursor = "" } vi . #ff00ff CellForeground/CellBackground . : { text = "CellBackground", cursor = "CellForeground" } search [colors.search] . #ff00ff CellForeground/CellBackground . matches = { foreground = "", background = "" } : { foreground = "#181818", background = "#ac4242" } focused_match = { foreground = "", background = "" } : { foreground = "#181818", background = "#f4bf75" } hints [colors.hints] . start = { foreground = "", background = "" } (hint label). #ff00ff CellForeground/CellBackground . : { foreground = "#181818", background = "#f4bf75" } end = { foreground = "", background = "" } (hint label). #ff00ff CellForeground/CellBackground . : { foreground = "#181818", background = "#ac4242" } line_indicator = { foreground = "", background = "" } vi . "None" (opposing primary color) . : { foreground = "None", background = "None" } footer_bar = { foreground = "", background = "" } (footer bar) URI . : { foreground = "#181818", background = "#d8d8d8" } selection = { text = "", background = "" } (selections). #ff00ff CellForeground/CellBackground . : { text = "CellBackground", background = "CellForeground" } normal [colors.normal] . black = "" : "#181818" red = "" : "#ac4242" green = "" : "#90a959" yellow = "" : "#f4bf75" blue = "" : "#6a9fb5" magenta = "" : "#aa759f" cyan = "" : "#75b5aa" white = "" : "#d8d8d8" bright [colors.bright] . black = "" : "#6b6b6b" red = "" : "#c55555" green = "" : "#aac474" yellow = "" : "#feca88" blue = "" : "#82b8c8" magenta = "" : "#c28cb8" cyan = "" : "#93d3c3" white = "" : "#f8f8f8" dim [colors.dim] . (dim) normal () . black = "" : "#0f0f0f" red = "" : "#712b2b" green = "" : "#5f6f3a" yellow = "" : "#a17e4d" blue = "" : "#456877" magenta = "" : "#704d68" cyan = "" : "#4d7770" white = "" : "#8e8e8e" indexed_colors = [{ index = , color = "" },] (indexed colors) . . : [] transparent_background_colors = true | false window.opacity . true . : false draw_bold_text_with_bright_colors = true | false true (bold) (bright) . : false (BELL) [bell] . animation = "Ease" | "EaseOut" | "EaseOutSine" | "EaseOutQuad" | "EaseOutCubic" | "EaseOutQuart" | "EaseOutQuint" | "EaseOutExpo" | "EaseOutCirc" | "Linear" . : "Linear" duration = . `duration` `0` . : 0 color = "" . : "#ffffff" command = "" | { program = "", args = ["",] } . "None" . : "None" (SELECTION) [selection] . semantic_escape_chars = "" << >> Alacritty . : ",|`|:\"' ()[]{}<>\t" save_to_clipboard = true | false true . : false (CURSOR) [cursor] . style = { , } shape = "Block" | "Underline" | "Beam" : "Block" blinking = "Never" | "Off" | "On" | "Always" Never Off On Always : "Off" vi_mode_style = { , } | "None" vi "None" . : "None" blink_interval = . : 750 blink_timeout = . 0 . : 5 unfocused_hollow = true | false true . : true thickness = 0.0 1.0. : 0.15 (TERMINAL) [terminal] . shell = "" | { program = "", args = ["",] } shell.program /bin/zsh. shell.args . : Linux/BSD/macOS: $SHELL $SHELL Windows: "powershell" : shell = { program = "/bin/zsh", args = ["-l"] } osc52 = "Disabled" | "OnlyCopy" | "OnlyPaste" | "CopyPaste" OSC 52 . . : "OnlyCopy" (MOUSE) [mouse] . hide_when_typing = true | false true . : false bindings = [{ , , , | | },] mods mode command chars action keyboard.bindings . Alacritty () `Shift` . `Shift` . mouse = "Middle" | "Left" | "Right" | "Back" | "Forward" | "WheelUp" | "WheelDown" | . action = | "ExpandSelection" ExpandSelection . : [mouse] bindings = [ { mouse = "Right", mods = "Control", action = "Paste" }, ] (HINTS) [hints] . (Terminal hints) . alphabet = "" . : "jfkdls;ahgurieowpq" enabled = [{ , , , , , , , },] . regex hyperlinks action command . regex = "" . hyperlinks = true | false true OSC 8 . post_processing = true | false true ( . ) . URI regex . persist = true | false true . action = "Copy" | "Paste" | "Select" | "MoveViModeCursor" Copy . Paste . Select . MoveViModeCursor vi . command = "" | { program = "", args = ["",] } binding . . binding = { key = "", mods = "", mode = "" } keyboard.bindings . . mouse = { mods = "", enabled = true | false } mods keyboard.bindings . enabled mods . : [[hints.enabled]] command = "xdg-open" # On Linux/BSD # command = "open" # On macOS # command = { program = "cmd", args = [ "/c", "start", "" ] } # On Windows hyperlinks = true post_processing = true persist = false mouse.enabled = true binding = { key = "O", mods = "Control|Shift" } regex = "(ipfs:|ipns:|magnet:|mailto:|gemini://|gopher://|https://|http://|news:|file:|git://|ssh:|ftp://)[^\u0000-\u001F\u007F-\u009F<>\"\\s{-}\\^<>`\\\\]+" (KEYBOARD) [keyboard] . bindings = [{ , , , | | },] "ReceiveChar" "None" . . key = "" "A" "0" "" . "F1" (Dead keys) : https://docs.rs/winit/latest/winit/keyboard/enum.NamedKey.html https://docs.rs/winit/latest/winit/keyboard/enum.Key.html#variant.Dead (Numpad) Numpad : "NumpadEnter" | "NumpadAdd" | "NumpadComma" | "NumpadDecimal" | "NumpadDivide" | "NumpadEquals" | "NumpadSubtract" | "NumpadMultiply" | "Numpad[0-9]". key (Scancode) . mods = "Command" | "Control" | "Option" | "Super" | "Shift" | "Alt" (Modifier) | : "Control | Shift". mode = "AppCursor" | "AppKeypad" | "Search" | "Alt" | "Vi" . ~ . | : "~Vi|Search". command = "" | { program = "", args = ["",] } . chars = "" . action ReceiveChar . None . Paste . Copy . IncreaseFontSize . DecreaseFontSize . ResetFontSize . ScrollPageUp . ScrollPageDown . ScrollHalfPageUp . ScrollHalfPageDown . ScrollLineUp . ScrollLineDown . ScrollToTop . ScrollToBottom . ClearHistory () . Hide Alacritty. Minimize Alacritty. Quit Alacritty. ClearLogNotice . SpawnNewInstance Alacritty. CreateNewWindow Alacritty. ToggleFullscreen . ToggleMaximized . ClearSelection . ToggleViMode vi. SearchForward . SearchBackward . Vi: Up . Down . Left . Right . First . Last . FirstOccupied . High . Middle . Low . SemanticLeft . SemanticRight . SemanticLeftEnd . SemanticRightEnd . WordLeft . WordRight . WordLeftEnd . WordRightEnd . Bracket . ParagraphUp () . ParagraphDown () . ToggleNormalSelection vi. ToggleLineSelection vi. ToggleBlockSelection vi. ToggleSemanticSelection vi. SearchNext . SearchPrevious . SearchStart . SearchEnd . Open (URL) vi. CenterAroundViCursor vi. InlineSearchForward . InlineSearchBackward . InlineSearchForwardShort . InlineSearchBackwardShort . InlineSearchNext . InlineSearchPrevious . SemanticSearchForward . SemanticSearchBackward . : SearchFocusNext . SearchFocusPrevious . SearchConfirm . SearchCancel . SearchClear (Regex) . SearchDeleteWord . SearchHistoryPrevious . SearchHistoryNext . macOS: ToggleSimpleFullscreen . HideOtherApplications Alacritty. CreateNewTab . SelectNextTab . SelectPreviousTab . SelectTab1 . SelectTab2 . SelectTab3 . SelectTab4 . SelectTab5 . SelectTab6 . SelectTab7 . SelectTab8 . SelectTab9 . SelectLastTab . Linux/BSD: CopySelection . PasteSelection . : alacritty-bindings(5) : [keyboard] bindings = [ { key = "N", mods = "Control|Shift", action = "CreateNewWindow" }, { key = "L", mods = "Control|Shift", chars = "l" }, ] (DEBUG) [debug] . Alacritty . . render_timer = true | false . : false persistent_logging = true | false Alacritty. : false log_level = "Off" | "Error" | "Warn" | "Info" | "Debug" | "Trace" : "Warn" ALACRITTY_EXTRA_LOG_TARGETS . : ALACRITTY_EXTRA_LOG_TARGETS="winit;vte" alacritty -vvv renderer = "glsl3" | "gles2" | "gles2pure" | "None" "None" . : "None" print_events = true | false . : false highlight_damage = true | false (Window damage). : false prefer_egl = true | false EGL API . EGL Linux/BSD . : false (SEE ALSO) alacritty(1), alacritty-msg(1), alacritty-bindings(5), alacritty- escapes(7) (BUGS) https://github.com/alacritty/alacritty/issues . (MAINTAINERS) o Christian Duerr o Kirill Chibisov 2026-04-06 ALACRITTY(5)