XTWINOPS: window operations

Status: xterm, derived from dtterm; most reports are widely implemented, most manipulations are not.

CSI Ps ; Ps ; Ps t

XTWINOPS covers window manipulation, size reports, and the title stack. These controls belong to xterm's Window Ops policy, which also covers features outside XTWINOPS, including OSC 52 clipboard access. With allowWindowOps false, xterm consults disallowedWindowOps per operation. Its default list denies title and icon-label reports but permits the other XTWINOPS operations listed below, subject to build options and other settings.

Operations

Ps	Operation	Report	xterm default policy
1	De-iconify		Allowed
2	Iconify		Allowed
3 ; x ; y	Move window		Allowed
4 ; h ; w	Resize window in pixels		Allowed
5	Raise		Allowed
6	Lower		Allowed
7	Refresh		Allowed
8 ; rows ; cols	Resize text area in cells		Allowed
9 ; 0/1/2/3	Restore / maximize / vertical / horizontal		Allowed
10 ; 0/1/2	Fullscreen off / on / toggle		Allowed
11	Report window state	CSI 1 t open, CSI 2 t iconified	Allowed
13 / 13 ; 2	Report position (window / text area)	CSI 3 ; x ; y t	Allowed
14 / 14 ; 2	Report text-area / window size in pixels	CSI 4 ; h ; w t	Allowed
15	Report screen size in pixels	CSI 5 ; h ; w t	Allowed
16	Report cell size in pixels	CSI 6 ; h ; w t	Allowed
18	Report text-area size in cells	CSI 8 ; rows ; cols t	Allowed
19	Report screen size in cells	CSI 9 ; rows ; cols t	Allowed
20	Report icon label	OSC L label ST	Disabled by default
21	Report title	OSC l title ST	Disabled by default
22 ; 0/1/2	Push icon and title / icon / title		Allowed
23 ; 0/1/2	Pop		Allowed
≥ 24	Resize to Ps rows (DECSLPP)		Allowed

Size reports

CSI 14 t, CSI 16 t, and CSI 18 t are the sanctioned way for an application to learn pixel geometry when TIOCGWINSZ returns zero ws_xpixel/ws_ypixel, which is common over SSH and under multiplexers. Image protocols depend on this; see Graphics.

Reports are asynchronous input; see Queries.

In-band resize notification (DEC mode ?2048) is a newer extension that sends CSI 48 ; rows ; cols ; height ; width t whenever the size changes, replacing SIGWINCH polling under multiplexers. Ghostty, kitty, foot, Contour, and WezTerm document it; see Modes.

Title stack

22/23 were added so applications could set a title and restore whatever was there without reading it, which 21 allows only when the user has opted in. The stack depth is small (xterm: 10). See OSC titles.

Title Ops: applying saved labels after a permitted 23 also checks Title Ops. With that permission disabled, a normal pop consumes the entry but leaves the labels unchanged. This label applies to that restoration step, not the other window operations on this page.

Probe

tools/query winsize      # CSI 18 t
tools/query cellsize     # CSI 16 t
tools/query pixsize      # CSI 14 t
tools/sendosc push-title; tools/sendosc title probe; sleep 2; tools/sendosc pop-title

Sources

• XTerm Control Sequences, XTWINOPS
• XTerm manual, allowWindowOps
• In-band window resize notifications
• kitty: in-band resize

Compatibility

Feature support by terminal. Imported claims have not been reverified; unknown is not unsupported.

Feature / stable ID	Alacritty	Apple Terminal	ConPTY (conhost)	Contour	DomTerm	foot	Ghostty	iTerm2	kitty	Konsole	mintty	mlterm	PuTTY	Revenant	RLogin	st	tmux	rxvt-unicode	VTE	wayst	WezTerm	Windows Terminal	xterm	xterm.js
2048 in band resize dec-mode-2048-in-band-resize	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	SupportedImported · unverified	Unknown	SupportedImported · unverified	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown	Unknown	Unknown
18 size in cells csi-18-t-text-size	SupportedImported · unverified	Unknown	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	Unknown	Unknown	SupportedImported · unverified	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified
14/16 pixel sizes csi-14-16-t-pixel-sizes	SupportedImported · unverified	Unknown	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified
22/23 title stack csi-22-23-t-title-stack	SupportedImported · unverified	Unknown	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	Unknown	Unknown	SupportedImported · unverified	Unknown	Unknown	Partial	Unknown	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified	SupportedImported · unverified
21 title report csi-21-t-title-report	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	SupportedImported · unverified	Supported	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown
Move/resize (3,4,8) csi-3-4-8-t-move-resize	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown	Unknown	Unknown	Unknown	SupportedImported · unverified	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	PartialImported · unverified	Unknown	SupportedImported · unverified	Unknown
XTWINOPS window operations csi-xtwinops	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
De-iconify csi-1-t-de-iconify	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Iconify csi-2-t-iconify	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Move window csi-3-t-move-window	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Resize window in pixels csi-4-t-resize-window-in-pixels	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Raise csi-5-t-raise	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Lower csi-6-t-lower	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Refresh csi-7-t-refresh	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Resize text area in cells csi-8-t-resize-text-area-in-cells	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Report window state csi-11-t-report-window-state	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Report screen size in pixels csi-15-t-report-screen-size-in-pixels	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Report cell size in pixels csi-16-t-report-cell-size-in-pixels	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Report screen size in cells csi-19-t-report-screen-size-in-cells	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Report icon label csi-20-t-report-icon-label	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Pop csi-23-t-pop	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Push icon and title / icon / title csi-22-t-push-title	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Report position (window / text area) csi-13-t-position-report	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Report text-area / window size in pixels csi-14-t-pixel-size-report	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Restore / maximize / vertical / horizontal csi-9-t-maximize	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown
Fullscreen off / on / toggle csi-10-t-fullscreen	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown	Unknown