Button-Event Mouse (1002)

Category: input · Tags: Xterm Extensions

Button-event tracking (mode 1002) reports mouse button press, release, and motion while a button is held. More detailed than basic tracking (1000) but less verbose than all-motion tracking (1003).

How this is tested: Enable mode 1002 via CSI ? 1002 h, verify via DECRPM that the mode is recognized.

Supported by 4 of 12 backends (33%)

Terminal Applications

Terminal	Version	Support	Notes
iTerm2	3.6.9	? unknown
Ghostty	1.3.1	? unknown
cmux	0.62.2	? unknown
Kitty	0.46.2	? unknown
VS Code	1.112.0	? unknown
Warp	0.2026.03.18.08.24.03	? unknown
Cursor	2.6.21	? unknown
Terminal.app	2.15	? unknown

Headless Backends

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

Backend	Version	Support	Notes
Alacritty	0.26.0	✓ yes
vt100	0.2.1	✓ yes
vterm	0.2.0	✓ yes
WezTerm	0.1.0-fork.5	✓ yes

← Back to matrix · input features