Ghostty v1.2.0: what changed and what to do before upgrading / osfeed

Before you upgrade to v1.2.0

2 to fix

Keybinds now use W3C key codes and the physical: prefix is removed; rewrite those keybinds with the W3C key code names.

Action requiredBind keys to Ghostty actions, including global shortcuts that work when Ghostty is not focused.Affects: Configs with keybinds that use the physical: prefixInferred

Read the evidence

ghostty-org/ghostty/pull/7320

libadwaita is now required, and the renderer needs OpenGL 4.3. Remove gtk-adwaita from your config: it no longer exists.

Action requiredRun a terminal emulator with a native app on macOS (SwiftUI, Metal) and Linux (GTK, OpenGL).Affects: Linux users and packagersInferred

Read the evidence

Discretionary ligatures (dlig) are off by default; turn them back on with font-features. On Linux, alpha-blending now defaults to linear-corrected.

Behavior changedSet fonts, colors, keybindings and window behavior in a plain-text config file.

Read the evidence

What changed in v1.2.0

Command palette (Ctrl+Shift+P on Linux, Cmd+Shift+P on macOS); background-image options; native progress bars for OSC 9;4; quick-terminal-size; the quick terminal on Wayland; global keybinds on GTK; FreeBSD support. Keybinds use W3C key codes and the physical: prefix is gone; libadwaita is required on Linux.

Also: Renamed options that still load: adw-toolbar-style is gtk-toolbar-style, gtk-tabs-location=hidden is window-show-tab-bar=never, selection/cursor-invert-fg-bg map to cell-foreground/cell-background colors, bold-is-bright maps to bold-color. Commands accept direct: and shell: prefixes.

v1.2.0. Linux needs libadwaita and OpenGL 4.3.

New things you can do

Run any keybind action by name from a command palette.

Added

Read the evidence

Show an image behind the terminal text with background-image, with options for opacity, position, fit and repeat.

Added

Read the evidence

ghostty-org/ghostty/blob/v1.2.0/src/config/Config.zig

See a native progress bar when a program reports progress with the OSC 9;4 sequence.

Added

Read the evidence

ghostty-org/ghostty/pull/7975

Undo closing a window, tab or split within a set time.

Added

Read the evidence

Fixed and improved

The quick terminal works on Linux under Wayland compositors with the layer-shell protocol, and its size can be set with quick-terminal-size.

ImprovedToggle a quick terminal that slides in from a screen edge or appears in the center.

Read the evidence

Global keybinds (global:) also work on GTK, where the desktop supports it.

ImprovedBind keys to Ghostty actions, including global shortcuts that work when Ghostty is not focused.

Read the evidence

ghostty-org/ghostty/blob/v1.2.0/src/config/Config.zig

Opt-in ssh-env and ssh-terminfo features make remote SSH sessions work better with Ghostty's terminal type.

ImprovedGet new tabs and splits that open in the current directory, prompt jumping and no close prompt at an idle shell, through automatic shell integration.Inferred

Read the evidence

ghostty-org/ghostty/pull/7608

The GTK app runs on FreeBSD.

ImprovedRun a terminal emulator with a native app on macOS (SwiftUI, Metal) and Linux (GTK, OpenGL).

Read the evidence

ghostty-org/ghostty/pull/7606