Skip to content

Pixel Mouse Reporting (1016) โ€‹

Category: input ยท Tags: Xterm Extensions ยท Specification โ†—

SGR-Pixels mouse mode (mode 1016) reports mouse coordinates in pixels rather than cells. This enables sub-cell precision for applications that need exact pointer positioning, such as terminal-based drawing tools or image viewers.
How this is tested: Enable SGR pixel mouse (CSI ? 1016 h), check getMode("pixelMouse") returns true.
Analysis2026-03-26

Supported by 7 of 8 terminals (88%). Not supported by: Cursor. Part of the Rich TUI baseline.

Supported by 10 of 13 backends (77%)

Terminal Applications โ€‹

TerminalVersionSupportNotes
iTerm23.6.9โœ“ yes
Ghostty1.3.1โœ“ yesSGR pixel mouse mode not tracked by ghostty-web WASM backend
VS Code1.112.0โœ“ yes
Warp0.2026.03.18.08.24.03โœ“ yes
Cursor2.6.21โœ“ yes
tmux3.6aโœ“ yes
Kitty0.46.2โœ“ yesSGR pixel mouse mode not exposed via Python batch bridge
Terminal.app2.15โœ“ yes
GNU Screen5.0.1โœ“ yes

Headless Backends โ€‹

Parser correctness only โ€” a โœ“ means the parser accepts the sequence.

BackendVersionSupportNotes
vterm0.2.0โœ“ yesSGR pixel mouse mode (?1016) not implemented
Alacritty0.26.0~ partialSGR pixel mouse mode not exposed via alacritty_terminal API
WezTerm0.1.0-fork.5~ partialSGR pixel mouse mode not exposed via wezterm-term API
vt1000.2.1โœ— noSGR pixel mouse mode not implemented โ€” pure TypeScript emulator

Powered by Termless
Playwright for Terminals