OSC 1 Set Icon Name
Set the name the window manager shows for the terminal's window when it is iconified.
OSC 1 ; Pt ST
OSC 1 ; Pt ST sets the window’s icon name, the label a window manager shows for it when it is iconified, and leaves the title alone. It is xterm’s, from dtterm, beside OSC 0, which sets both, and OSC 2, which sets the title. Sun’s and dtterm’s older form of it is OSC L Pt ST, with the letter L and no ;.
Unlike OSC 0 and OSC 2, a default xterm keeps only the low seven bits of each character of an icon name, so anything beyond ASCII comes out changed (doparsing). Few desktops show icon names now, and a case cannot see one: what it can see is that the title does not change.
libghostty-vt has no icon name, and ignores OSC 1, which leaves the title alone as xterm does.
Support
| Terminal | Version | Support | Notes |
|---|---|---|---|
| VT220 | manual, 2nd ed., 1984 | No | OSC is not among the controls it recognizes (§4.2) |
| VT510 | manual, 1st ed., 1993 | No | ignores an OSC string (chapter 4) |
| xterm | patch 412, xterm-411a | Yes | keeps only the low seven bits of each character |
| libghostty-vt | 0f171f6 | No | ignored, leaving the title alone |
| Konsole | 26.11.70, a24c3d71 | Yes | kept as the session’s icon text, which its source says is not used |
| ConEmu | build 230724, its documentation | Partly | listed with OSC 0 and OSC 2 as setting the console window title, not an icon name: ANSI escape codes |
Validation
OSC1-1: The title is left alone
\e]2;Window\a
\e]1;Icon\a
|___|
title "Window"
OSC1-2: Nothing on screen
A
\e]1;Icon\e\\
B
|AB_|
cursor 1,3