Skip to main content

Fullscreen

AI-Generated Content
This page was generated with the assistance of AI and may contain inaccuracies. It is intended as a placeholder for future human verification. If you spot issues ahead of its initial review, please report them on GitHub!
Experimental

Fullscreen is an XTerm window manipulation sequence that enters, exits, or toggles fullscreen mode for the terminal window.

Syntax​

CSI 10 ; Ps t     Enter, exit, or toggle fullscreen
Formal syntax
fullscreen = 0x1b, "[", "1", "0", ";", Ps, "t" ;
Ps         = "0" | "1" | "2" ;

Parameters​

ValueDescription
0Exit fullscreen (restore to windowed mode)
1Enter fullscreen
2Toggle fullscreen

Description​

This sequence controls the fullscreen state of the terminal window. It is part of the XTerm CSI Ps ; Ps ; Ps t window manipulation family.

  • CSI 10 ; 0 t — Exits fullscreen mode. The window is restored to its previous windowed size and position, with window decorations visible.
  • CSI 10 ; 1 t — Enters fullscreen mode. The window expands to cover the entire screen, and window decorations (title bar, borders) are hidden.
  • CSI 10 ; 2 t — Toggles fullscreen mode. If the window is currently in fullscreen, it exits fullscreen; if windowed, it enters fullscreen.

Fullscreen mode differs from Maximize in that fullscreen typically removes all window decorations and may cover system UI elements such as taskbars and docks. Maximize mode retains decorations and respects the work area.

note

Some terminal emulators disable these sequences by default for security reasons. Check your terminal's configuration for options to enable or disable window manipulation sequences.

Examples​

# Enter fullscreen
printf '\e[10;1t'

# Exit fullscreen
printf '\e[10;0t'

# Toggle fullscreen
printf '\e[10;2t'

Specifications​

SpecificationSection
XTerm ctlseqs—

Terminal support​

TerminalSupportVersionNotes
Terminal Emulators
Alacritty✗NoRejected per escape_support.md:81-82
Bobcat✓0.9.0Handled via WhenWindowFullScreen callback; requires WindowActions enabled in profile
contour✗NoNot implemented in WINDOWMANIP handler
foot✗NoCSI 10 t logs unimplemented warning
Ghostty✗NoCSI 10;Ps t not implemented
iTerm2✗NoCSI 10;Ps t not implemented
Kitty✗NoCSI 10 t not supported
Konsole✗NoCSI 10 t not implemented
mintty✓YesCSI 10;0/1/2 t implemented
mlterm✗NoCSI 10 t explicitly not supported (comment in code)
PuTTY✗NoCSI 10 t not implemented; switch statement has cases 1-9, 11, 13-14, 18, 20-21 only
Rio✗No
rxvt-unicode✗NoNot implemented in process_window_ops
st✗NoNo CSI t window manipulation sequences implemented
terminology✗No
VT100✗No
VTE~YesParsed but implementation is stub - breaks without action
WezTerm✗NoParsed but handled as unimplemented
Windows Terminal✗NoCSI 10;Ps t not in WindowManipulationType enum
xterm✓xterm-93Requires --enable-maximize compile flag (default on)
xterm.js✓4.4.0CSI 10;Ps t. Requires windowOptions.fullscreenWin enabled.
Multiplexers
cy✗NoExplicitly ignored
GNU Screen✗NoCSI 10;Ps t not implemented
tmux✗NoSequence parsed but ignored (case 10 in winops)
tuios✗NoCSI 10 t not handled
Zellij✗No

See also​

  • Maximize — Maximize the window while retaining decorations
  • Iconify — Minimize or restore the window
  • Resize (chars) — Resize to specific character dimensions