Skip to content

Highlight background (OSC 17)

Category: extensions · Tags: Operating System Commands (OSC), Xterm Extensions · Specification ↗

ESC ] 17 ; spec BEL
OSC 17 sets or queries the terminal's selection highlight background color. The query is ESC ] 17 ; ? BEL and the terminal responds with the color in X11 rgb:RR/GG/BB format, matching the OSC 10/11 response pattern. Setting uses ESC ] 17 ; spec BEL where spec is an X11 color name or rgb:RR/GG/BB. This allows applications to customize the selection appearance — useful for themes that need the selection highlight to contrast with custom foreground/background colors. Supported by xterm, iTerm2, foot, and other xterm-compatible terminals.
How this is tested: Query highlight background color with OSC 17 ; ? BEL, verify response matches OSC 17 ; rgb:... pattern via feedCapture.
Analysis2026-04-06

Supported by 2 of 8 terminals (25%). Part of the Rich TUI baseline.

Supported by 2 of 14 backends (14%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9✓ yes
Kitty0.46.2✓ yesOSC 17 highlight background query requires a real display — headless backends have no color palette to query
Ghostty1.3.1✗ noNo OSC 17 response
VS Code1.113.0? unknown
Warp0.2026.03.18.08.24.03? unknown
Cursor2.6.21? unknown
Terminal.app2.15? unknown

Headless Backends

Parser correctness only — a means the parser accepts the sequence.

BackendVersionSupportNotes
Alacritty0.26.0✗ noOSC 17 highlight background query requires a real display — headless backends have no color palette to query
vt100.js0.2.1✗ noNot implemented — pure TypeScript emulator
vterm0.2.0✗ noOSC 17 highlight background query not implemented in vterm.js
WezTerm0.1.0-fork.5✗ noOSC 17 highlight background query requires a real display — headless backends have no color palette to query
xterm.js5.5.0✗ noOSC 17 highlight background query requires a real display — headless backends have no color palette to query