Alacritty Versions Save

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
• window.resize_increments config option, disabled by default

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
• EOT (\x03) escaping bracketed paste mode
• Drag & Drop not working for the search bar
• Simple-fullscreened window not resized when moving between monitors on macOS

Removed

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

Fixed

• Memory leak on macOS
• Pasting from Alacritty freezing the target application

Added

• window.resize_increments config option, disabled by default

Fixed

• EOT (\x03) escaping bracketed paste mode
• Drag & Drop not working for the search bar
• Simple-fullscreened window not resized when moving between monitors on macOS
• When using window.resize_increments maximizing the window not taking full space on macOS

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