Features›Modes›Mouse tracking (DECSET 1000)

Mouse tracking (DECSET 1000)

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

ESC [ ? 1000 h

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.

How this is testedautomated
Send \x1b[?1000h (DECSET 1000), verify mouseTracking mode is active.

The same probe runs against headless backends (via Termless) and real terminal apps (via a daemon launched in each terminal). This lets us distinguish parser correctness from rendering correctness.

Analysis2026-04-06

Supported by 11 of 12 terminals (92%). Not supported by: vt100.js. Part of the Modern TUI baseline. Notes: vt100.js: Not in VT100/VT220 — xterm extension.

Supported by 12 of 14 backends (86%)

Terminal Applications

Terminal	Version	Support	Notes
iTerm2	3.6.9	✓ yes	DECRPM: mode reset
Ghostty	1.3.1	✓ yes	DECRPM: mode reset
VS Code		✓ yes
Warp		✓ yes
Cursor		✓ yes
Terminal.app		✓ yes

Headless Backends

Parser correctness only — a ✓ means the parser accepts the sequence.

Backend	Version	Support	Notes
Alacritty	0.26.0	✓ yes
vterm	0.2.0	✓ yes
WezTerm	0.1.0-fork.5	✓ yes
xterm.js	5.5.0	✓ yes
Kitty	0.40.0	~ partial	Not exposed via Python batch bridge
vt100.js	0.2.1	✗ no	Not in VT100/VT220 — xterm extension

← Back to matrix · modes features