Skip to content

Mouse tracking (DECSET 1000)

Category: modes · Tags: DEC Private Modes, Xterm Extensions · Specification ↗

DECSET 1000 enables basic mouse click reporting (Normal tracking mode). The sequence is ESC [ ? 1000 h. When enabled, button press and release events are reported to the application. The legacy X10 encoding reports coordinates as single bytes offset by 32, limiting reports to the first 223 columns/rows. For larger terminals, use SGR mouse mode (DECSET 1006) instead.

Supported by 5 of 6 backends (83%)

Support Matrix

BackendVersionSupportNotes
Alacritty0.26.0✓ yes
Ghostty1.3.1✓ yes
vt1000.1.0✓ yes
WezTerm0.1.0-fork.5✓ yes
xterm.js5.5.0✓ yes
Kitty0.40.0~ partialNot exposed via Python batch bridge

Powered by Termless
Playwright for Terminals