^[control-codes
live in libghostty-vt

Operating system commands

OSC 11 Text Background Color

View as Markdown

Set and query the color of the default background, behind text with no SGR background color.

OSC 11 ; Pt ST
ECMA-48
§8.3.89 OSC – Operating System Command, p. 51
xterm
Operating System Commands

OSC 11 ; Pt ST sets the color of the default background, behind text with no SGR background color, and OSC 11 ; ? ST asks what it is. OSC 111 puts it back as it started. It is one of xterm’s dynamic colors, and works as OSC 10 explains: Pt is any color X11 can parse, and a further ; in the same sequence moves on to color 12.

A default xterm starts it as the background resource, white (charproc.c), so in the terminal the cases run in, set up as a default xterm, it is reported as rgb:ffff/ffff/ffff.

libghostty-vt has it, and agrees with xterm.

Support

TerminalVersionSupportNotes
VT220manual, 2nd ed., 1984NoOSC is not among the controls it recognizes (§4.2)
VT510manual, 1st ed., 1993Noignores an OSC string (chapter 4)
xtermpatch 412, xterm-411aYes
libghostty-vt0f171f6Yes
Konsole26.11.70, a24c3d71Yessets and answers one color; no chain
kitty0.49.1, run in a VMYespasses the case that shows it working; ends its replies with ST where xterm uses BEL
foot1.28.0, run in a VMYespasses the case that shows it working
pyte0.8.2, run as a libraryNofails the case that shows it working
xterm.js headless6.0.0, run as a libraryNofails the case that shows it working
alacritty_terminal0.26.0, run as a libraryYespasses the case that shows it working
ConEmubuild 230724, its documentationNonot in its ANSI escape codes
rxvt-unicode9.31, run in a VMYespasses the case that shows it working; writes colors as ff00 where xterm writes ffff
VTE0.84.1, run as a libraryYespasses the case that shows it working

Validation

OSC11-1: Ask for it

\e]11;?\a
|____|
reply \e]11;rgb:ffff/ffff/ffff\a

OSC11-2: Change it

\e]11;#0080ff\a
\e]11;?\a
|____|
reply \e]11;rgb:0000/8080/ffff\a

OSC11-3: The answer ends as the question did

\e]11;?\e\\
|____|
reply \e]11;rgb:ffff/ffff/ffff\e\\

OSC11-4: RIS leaves it alone

\e]11;red\a
\ec
\e]11;?\a
|____|
reply \e]11;rgb:ffff/0000/0000\a
Every example on these pages runs in your browser, in libghostty-vt compiled to WebAssembly.