alacritty

Added

• Default Home/End bindings in Vi mode mapped to First/Last respectively

Fixed

• CLI env variables clearing configuration file variables
• Vi inline search/semantic selection expanding across newlines
• C0 and C1 codes being emitted in associated text when using kitty keyboard
• Occasional hang on startup with some Wayland compositors
• Missing key for NumpadDecimal in key bindings
• Scrolling content upwards moving lines into history when it shouldn't
• Sticky keys not working sometimes on X11
• Modifiers occasionally getting desynced on X11
• Autokey no longer working with alacritty on X11
• Freeze when moving window between monitors on Xfwm
• Mouse cursor not changing on Wayland when cursor theme uses legacy cursor icon names
• Config keys are available under proper names
• Build failure when compiling with x11 feature on NetBSD
• Hint Select action selecting the entire line for URL escapes

Changed

• No unused-key warnings will be emitted for OS-specific config keys
• Use built-in font for sextant symbols from U+1FB00 to U+1FB3B
• Kitty encoding is not used anymore for uncommon keys unless the protocol enabled

Added

• Support for pasting in Vi + Search mode

Changed

• alacritty migrate will ignore null values in yaml instead of erroring out

Fixed

• alacritty migrate failing with nonexistent imports
• Alt bindings requiring composed key rather than pre-composed one on macOS
• Alt + Control bindings not working on Windows
• chars = "\u000A" action in bindings inserting \n
• Alternate keys not sent for Shift + <number> when using kitty protocol
• Alternative keys being swapped in kitty protocol implementation
• Powerline glyphs being cut for narrow fonts
• Xmodmap not working on X11
• Occasional slow startup on some X11 window managers
• Blurry window when using window.dimensions on some Wayland compositors
• IME input lagging behind on X11
• xdotool modifiers input not working correctly on X11
• Parsing numbers fails for mouse bindings
• Some config options overriding each other in CLI/IPC
• Numpad Left used for numpad Up

Added

• Support for pasting in Vi + Search mode

Changed

• alacritty migrate will ignore null values in yaml instead of erroring out

Fixed

• alacritty migrate failing with nonexistent imports
• Alt bindings requiring composed key rather than pre-composed one on macOS
• Alt + Control bindings not working on Windows
• chars = "\u000A" action in bindings inserting \n
• Alternate keys not sent for Shift + <number> when using kitty protocol
• Alternative keys being swapped in kitty protocol implementation
• Powerline glyphs being cut for narrow fonts
• Xmodmap not working on X11
• Occasional slow startup on some X11 window managers
• Blurry window when using window.dimensions on some Wayland compositors
• IME input lagging behind on X11
• xdotool modifiers input not working correctly on X11
• Parsing numbers fails for mouse bindings
• Some config options overriding each other in CLI/IPC
• Numpad Left used for numpad Up

Packaging

• Minimum Rust version has been bumped to 1.70.0
• Manpages are now generated using scdoc (see INSTALL.md)

Added

• Warnings for unused configuration file options
• Config option persist in hints config section
• Support for dynamically loading conpty.dll on Windows
• Support for keybindings with dead keys
• Back/Forward mouse buttons support in bindings
• Copy global IPC options (-w -1) for new windows
• Bindings to create and navigate tabs on macOS
• Support startup notify protocol to raise initial window on Wayland/X11
• Debug option prefer_egl to prioritize EGL over other display APIs
• Inline vi-mode search using f/F/t/T
• window.blur config option to request blur for transparent windows
• --option argument for alacritty msg create-window
• Support for DECRQM/DECRPM escape sequences
• Support for kitty's keyboard protocol

Changed

• Mode-specific bindings can now be bound in any mode for easier macros
• --help output is more compact now and uses more neutral palette
• Configuration file now uses TOML instead of YAML
  Run alacritty migrate to automatically convert all configuration files
• Deprecated config option draw_bold_text_with_bright_colors, use
  colors.draw_bold_text_with_bright_colors
• Deprecated config option key_bindings, use keyboard.bindings
• Deprecated config option mouse_bindings, use mouse.bindings
• The default colorscheme is now based on base16 classic dark
• IME popup now tries to not obscure the current cursor line
• The double click threshold was raised to 400ms
• OSC 52 paste ability is now disabled by default; use terminal.osc52 to adjust it
• Apply colors.transparent_background_colors for selections, hints, and search matches
• Underline full hint during keyboard selection
• Synchronized updates now use CSI 2026 instead of legacy DCS variant
• In mouse mode with Shift pressed, mouse bindings without Shift are only triggered
  if no exact binding (i.e. one with Shift) is found.
• Use built-in font for powerline symbols from U+E0B0 to U+E0B3
• Default bell.animation is now Linear
• IncreaseFontSize/DecreaseFontSize step is now 1px
• font.size precision was raised to 6 floating point digits
• Default font size to 11.25 matching 15px
• Xft.dpi is now reloaded when xsettingd change its value on X11

Fixed

• Unconditional query of xdg-portal settings on Wayland
• Maximized startup mode not filling the screen properly on GNOME Wayland
• OptionAsAlt with OnlyLeft/OnlyRight settings not working properly on macOS
• Default Vi key bindings for Last/First actions not working on X11/Wayland
• Cut off wide characters in preedit string
• Scrolling on touchscreens
• Double clicking on CSD titlebar not always maximizing a window on Wayland
• Excessive memory usage when using regexes with a large number of possible states
• window.decorations_theme_variant not live reloading
• Copy/Paste being truncated to 64KiB on Wayland
• X11 clipboard lagging behind sometimes
• High wakeup count on Wayland due to clipboard polling
• Blocking paste freezing alacritty on Wayland
• Command modifier persisting after Cmd + Tab on macOS
• Crash on exit when using NVIDIA binary drivers on Wayland
• window.startup_mode applied to window again when creating new tab
• Crash when leaving search after resize
• Cursor being hidden after reaching cursor blinking timeout
• Message bar content getting stuck after closing with multiple messages on Wayland
• Vi cursor position not redrawn on PageUp/PageDown without scrollback
• Cursor not updating when blinking and viewport is scrolled
• Failure to start with recent version of mesa's i915 driver
• Error when using chars inside the mouse bindings

Removed

• Config option background_opacity, use window.background_opacity
• Config option colors.search.bar, use colors.footer_bar instead
• Config option mouse.url, use the hints config section
• Config options mouse.double_click and mouse.triple_click

Packaging

• Minimum Rust version has been bumped to 1.70.0
• Manpages are now generated using scdoc (see INSTALL.md)

Added

• Warnings for unused configuration file options
• Config option persist in hints config section
• Support for dynamically loading conpty.dll on Windows
• Support for keybindings with dead keys
• Back/Forward mouse buttons support in bindings
• Copy global IPC options (-w -1) for new windows
• Bindings to create and navigate tabs on macOS
• Support startup notify protocol to raise initial window on Wayland/X11
• Debug option prefer_egl to prioritize EGL over other display APIs
• Inline vi-mode search using f/F/t/T
• window.blur config option to request blur for transparent windows
• --option argument for alacritty msg create-window
• Support for DECRQM/DECRPM escape sequences
• Support for kitty's keyboard protocol

Changed

• Mode-specific bindings can now be bound in any mode for easier macros
• --help output is more compact now and uses more neutral palette
• Configuration file now uses TOML instead of YAML
  Run alacritty migrate to automatically convert all configuration files
• Deprecated config option draw_bold_text_with_bright_colors, use
  colors.draw_bold_text_with_bright_colors
• Deprecated config option key_bindings, use keyboard.bindings
• Deprecated config option mouse_bindings, use mouse.bindings
• The default colorscheme is now based on base16 classic dark
• IME popup now tries to not obscure the current cursor line
• The double click threshold was raised to 400ms
• OSC 52 paste ability is now disabled by default; use terminal.osc52 to adjust it
• Apply colors.transparent_background_colors for selections, hints, and search matches
• Underline full hint during keyboard selection
• Synchronized updates now use CSI 2026 instead of legacy DCS variant
• In mouse mode with Shift pressed, mouse bindings without Shift are only triggered
  if no exact binding (i.e. one with Shift) is found.
• Use built-in font for powerline symbols from U+E0B0 to U+E0B3
• Default bell.animation is now Linear
• IncreaseFontSize/DecreaseFontSize step is now 1px
• font.size precision was raised to 6 floating point digits
• Default font size to 11.25 matching 15px

Fixed

• Unconditional query of xdg-portal settings on Wayland
• Maximized startup mode not filling the screen properly on GNOME Wayland
• OptionAsAlt with OnlyLeft/OnlyRight settings not working properly on macOS
• Default Vi key bindings for Last/First actions not working on X11/Wayland
• Cut off wide characters in preedit string
• Scrolling on touchscreens
• Double clicking on CSD titlebar not always maximizing a window on Wayland
• Excessive memory usage when using regexes with a large number of possible states
• window.decorations_theme_variant not live reloading
• Copy/Paste being truncated to 64KiB on Wayland
• X11 clipboard lagging behind sometimes
• High wakeup count on Wayland due to clipboard polling
• Blocking paste freezing alacritty on Wayland
• Command modifier persisting after Cmd + Tab on macOS
• Crash on exit when using NVIDIA binary drivers on Wayland
• window.startup_mode applied to window again when creating new tab
• Crash when leaving search after resize
• Cursor being hidden after reaching cursor blinking timeout
• Message bar content getting stuck after closing with multiple messages on Wayland
• Vi cursor position not redrawn on PageUp/PageDown without scrollback
• Cursor not updating when blinking and viewport is scrolled
• Failure to start with recent version of mesa's i915 driver
• Error when using chars inside the mouse bindings

Removed

• Config option background_opacity, use window.background_opacity
• Config option colors.search.bar, use colors.footer_bar instead
• Config option mouse.url, use the hints config section
• Config options mouse.double_click and mouse.triple_click

Fixed

• Crash on macOS Sonoma due to change in macOS resize handling
• Crash when Wayland compositor advertises wl_compositor@v5 interface

Fixed

• Crash on macOS Sonoma due to change in macOS resize handling
• Crash when Wayland compositor advertises wl_compositor@v5 interface

Fixed

• Hyperlink preview not being shown when the terminal has exactly 2 lines
• Crash on Windows when changing display scale factor
• Freeze with some drivers when using GLX
• Crash when shrinking the terminal scrolled into the history

Fixed

• Hyperlink preview not being shown when the terminal has exactly 2 lines
• Crash on Windows when changing display scale factor
• Freeze with some drivers when using GLX
• Crash when shrinking the terminal scrolled into the history

Fixed

• Very long startup times on Wayland systems with broken xdg-portal setup
• Error on startup with GLX when using old mesa platforms
• Character ; inside the URI in OSC 8 sequence breaking the URI
• Selection on last line not updating correctly on resize
• Keyboard input not working on macOS with some IMEs like Fig.io

Fixed

• Very long startup times on Wayland systems with broken xdg-portal setup
• Error on startup with GLX when using old mesa platforms

Fixed

• Character ; inside the URI in OSC 8 sequence breaking the URI
• Selection on last line not updating correctly on resize
• Keyboard input not working on macOS with some IMEs like Fig.io

Added

• Uppercase -T short form for --title
• Support for horizontal scrolling in mouse mode and alternative scrolling modes
• Support for fractional scaling on Wayland with wp-fractional-scale protocol
• Support for running on GLES context
• Touchscreen input for click/scroll/select/zoom

Changed

• Always use sRGB color space on macOS
• Erase in line after the last column will no longer clear the last column
• Open new windows by default with macOS Cmd+N binding
• The hint about window transparency is now properly issued on Wayland and macOS
• window.decorations_theme_variant could now control theme on macOS and Windows
• The IME purpose is now set to Terminal which could help with OSK
• window.decorations_theme_variant is now using Dark, Light, and None values
• Resize increments are now set on macOS and X11 to resize by cell sizes

Fixed

• --help output for --class does not match man pages
• Cursor and underlines always being black on very old hardware
• Crash when using very low negative font.offset
• Startup failure on macOS with default config when system /bin/sh is dash
• Artifacts in corners for maximized window with CSD on Wayland
• Dotted underline not shown on macOS
• Underline on macOS always being at the bottom of the cell
• Crash with OT-SVG fonts on Linux/BSD
• Crash during text compose on old GNOME under Wayland
• Mouse cursor staying hidden after window regains focus on macOS Ventura
• Blurry fonts when changing padding size at runtime
• Crash while typing on Wayland
• Multi-line semantic bracket selection
• Reduced GPU memory usage
• Low frame rate when multiple windows render at the same time
• Redraw hanging until a keypress on X11 in rare cases
• Window clipping when maximizing a window without decorations on Windows
• Quadrants not aligned with half blocks with built-in font

Removed

• window.gtk_theme_variant config field; use window.decorations_theme_variant instead
• alt_send_esc is now always set to true

macOS Alt/Option situation

This release removed the alt_send_esc option entirely in favor of option_as_alt in window section. This option
behaves like iterm2's ESC+ or Terminal.app's option as meta. So for example to make your left option
as alt, you do:

window:
    option_as_alt: OnlyLeft

However some keyboard layouts are using Alt + 8 to enter the [ character and you don't want to send ESC for them.
For these layouts you must define bindings yourself in key_bindings section, but be aware that key bindings that were
floating around in different issues may not be working anymore, so the recommended way
to bind those keys is to do the following:

1. Run alacritty --print-events | grep -i keyboardinput.
2. Press problematic key bindings on such layouts, for example Alt + 8.
3. In the output you'll see something like KeyboardInput { device_id: DeviceId(DeviceId), input: KeyboardInput { scancode: 28, state: Pressed, virtual_keycode: Some(LBracket), modifiers: ALT }, is_synthetic: false } }.
4. Add a binding like - { key: LBracket, mods: Alt, chars: "[" }, the key is virtual_keycode from step 3 if it end up being None you can write key: 28, where 28 is scancode from 3.
5. Repeat 1-4 until you are done.

Packaging

• Minimum Rust version has been bumped to 1.57.0
• Renamed io.alacritty.Alacritty.appdata.xml to org.alacritty.Alacritty.appdata.xml
• Renamed io.alacritty to org.alacritty for Alacritty.app

Added

• Track and report surface damage information to Wayland compositors
• Escape sequence for undercurl, dotted and dashed underlines (CSI 4 : [3-5] m)
• ToggleMaximized key binding action to (un-)maximize the active window, not bound by default
• Support for OpenGL ES 2.0
• Escape sequence to set underline color (CSI 58 : 2 : Ps : Ps : Ps m/CSI 58 : 5 : Ps m)
• Escape sequence to reset underline color (CSI 59 m)
• Vi mode keybinding (z) to center view around vi mode cursor
• Accept hexadecimal values starting with 0x for --embed
• Config option cursor.blink_timeout to timeout cursor blinking after inactivity
• Escape sequence to set hyperlinks (OSC 8 ; params ; URI ST)
• Config hints.enabled.hyperlinks for hyperlink escape sequence hint highlight
• window.decorations_theme_variant to control both Wayland CSD and GTK theme variant on X11
• Support for inline input method

Changed

• No longer renders to macos and x11 windows that are fully occluded / not directly visible
• The --help output was reworked with a new colorful syntax
• OSC 52 is now disabled on unfocused windows
• SpawnNewInstance no longer inherits initial --command
• Blinking cursor will timeout after 5 seconds by default
• Deprecated colors.search.bar, use colors.footer_bar instead
• On macOS, Alacritty now reads AppleFontSmoothing from user defaults to control font smoothing
• Warn when either columns or lines is non-zero, but not both
• Client side decorations should have proper text rendering now on Wayland
• Config option window.gtk_theme_variant, you should use window.decorations_theme_variant instead
• --class now sets both class part of WM_CLASS property and instance
• --class's general and instance options were swapped
• Search bar is now respecting cursor thickness
• On X11 the IME popup window is stuck at the bottom of the window due to Xlib limitations
• IME no longer works in Vi mode when moving around

Fixed

• Creating the IPC socket failing if WAYLAND_DISPLAY contains an absolute path
• Crash when resetting the terminal while in vi mode
• font.glyph_offset not live reloading
• Failure when running on 10-bit color system
• The colors being slightly different when using srgb displays on macOS
• Vi cursor blinking not reset when navigating in search
• Scrolling and middle-clicking modifying the primary selection
• Bottom gap for certain builtin box drawing characters
• Incorrect built-in glyphs for U+2567 and U+2568
• Character mappings in the DEC special graphics character set (line drawing)
• Window flickering on resize on Wayland
• Unnecessary config reload when using /dev/null as a config file
• Windows Open Alacritty Here on root of drive displaying error
• On macOS, font.use_thin_strokes did not work since Big Sur
• On macOS, trying to load a disabled font would crash
• On macOS, Alacritty sessions did not appear in the list of tty sessions for w and who
• Cursor not hiding on GNOME Wayland
• Font having different scale factor after monitor powering off/on on X11
• Viewport not updating after opening a new tabbed window on macOS
• Terminal not exiting sometimes after closing all windows on macOS
• CPU usage spikes due to mouse movements for unfocused windows on X11/Windows
• First window on macOS not tabbed with system prefer tabs setting
• Window being treaten as focused by default on Wayland

Removed

• font.use_thin_strokes config field; to use thin strokes on macOS, set
  AppleFontSmoothing to 0 with $ defaults write -g AppleFontSmoothing -int 0

Fixed

• Missing window icon on X11
• Crash when closing IME on X11
• Alt key handling on Windows

Added

• Option font.builtin_box_drawing to disable the built-in font for drawing box characters

Changed

• Builtin font thickness is now based on cell width instead of underline thickness

Fixed

• OSC 4 not handling ?
• ? in OSC strings reporting default colors instead of modified ones
• OSC 104 not clearing colors when second parameter is empty
• Builtin font lines not contiguous when font.offset is used
• font.glyph_offset is no longer applied on builtin font
• Buili-in font arcs alignment
• Repeated permission prompts on M1 macs
• Colors being slightly off when using colors.transparent_background_colors

Added

• Option font.builtin_box_drawing to disable the built-in font for drawing box characters

Changed

• Builtin font thickness is now based on cell width instead of underline thickness

Fixed

• OSC 4 not handling ?
• ? in OSC strings reporting default colors instead of modified ones
• OSC 104 not clearing colors when second parameter is empty
• Builtin font lines not contiguous when font.offset is used
• font.glyph_offset is no longer applied on builtin font
• Buili-in font arcs alignment
• Repeated permission prompts on M1 macs
• Colors being slightly off when using colors.transparent_background_colors

Packaging

• New extra/alacritty-msg.man manpage for the alacritty msg subcommand
• Minimum Rust version has been bumped to 1.53.0

Added

• Option colors.transparent_background_colors to allow applying opacity to all background colors
• Support for running multiple windows from a single Alacritty instance (see docs/features.md)
• Urgency support on Wayland via xdg_activation_v1

Changed

• ExpandSelection is now a configurable mouse binding action
• Config option background_opacity, you should use window.opacity instead
• Reload configuration files when their symbolic link is replaced
• Strip trailing whitespaces when yanking from a block selection
• Display area keeps history position when viewport is cleared
• Commands spawn from the current directory of the foreground shell in Unix-like systems
• Remove trailing newline from strings taken from hints or simple/semantic selections
• Builtin font is now used for box drawing characters from U+2500 to U+259f
• Logs now print the time since startup instead of the local time

Fixed

• Line indicator obstructing vi mode cursor when scrolled into history
• Vi mode search starting in the line below the vi cursor
• Invisible cursor with matching foreground/background colors
• Crash when hovering over a match emptied by post-processing
• Crash when the vi cursor is on the scrollback and viewport clear is invoked
• Freeze when the vi cursor is on the scrollback and scrollback clear is invoked
• Vi cursor on topmost of the display moving downward when scrolled into history with active output
• Input lag on Wayland with Nvidia binary driver
• Crash when hovering the mouse over fullwidth characters
• Do not create logfile if the file already exists

Packaging

• Minimum Rust version has been bumped to 1.46.0

Added

• Support for ipfs/ipns URLs
• Mode field for regex hint bindings

Fixed

• Regression in rendering performance with dense grids since 0.6.0
• Crash/Freezes with partially visible fullwidth characters due to alt screen resize
• Incorrect vi cursor position after invoking ScrollPage* action
• Slow PTY read performance with extremely dense grids
• Crash when resizing during vi mode
• Unintentional text selection range change after leaving vi mode
• Deadlock on Windows during high frequency output
• Search without vi mode not starting at the correct location when scrolled into history
• Crash when starting a vi mode search from the bottommost line
• Original scroll position not restored after canceling search
• Clipboard copy skipping non-empty cells when encountering an interrupted tab character
• Vi mode cursor moving downward when scrolled in history with active output
• Crash when moving fullwidth characters off the side of the terminal in insert mode
• Broken bitmap font rendering with FreeType 2.11+
• Crash with non-utf8 font paths on Linux
• Newly installed fonts not rendering until Alacritty restart

Fixed

• Crash when moving fullwidth characters off the side of the terminal in insert mode