Mouse and touchpad malfunctions and crashes #23653

Closed
opened 2026-01-31 08:48:17 +00:00 by claunia · 2 comments
Owner

Originally created by @MicroDevX on GitHub (Sep 27, 2025).

Windows Terminal version

1.24.2682.0

Windows build number

10.0.26220.0

Other Software

No response

Steps to reproduce

🐛 Bug Report: Touchpad Scrolling Malfunction after Commit b53d7df
Windows Terminal Version
1.24.2682.0 (Preview)

Windows Build Number
10.0.26220.0

Commit Introduced
b53d7df Add support for VT horizontal mouse wheel events

Problem Description
After upgrading to Windows Terminal Preview v1.24.2682.0, touchpad scrolling inside the terminal became unreliable:

Vertical scrolling with two fingers on a touchpad often does not work.

In some cases, scrolling works but behaves erratically (jumping, inconsistent speed, or misinterpreted as horizontal scroll).

This issue was not present in v1.23 Stable.

Steps to Reproduce
Install Windows Terminal Preview v1.24.2682.0 on Windows build 10.0.26220.0.

Open any terminal session (PowerShell, WSL, or CMD).

Use a laptop touchpad to scroll vertically with two fingers.

Observe that scrolling is either non-functional or inconsistent.

Expected Behavior
Smooth and consistent vertical scrolling using the touchpad, identical to behavior in v1.23.

Horizontal scrolling should only trigger when explicitly performed by the user (e.g., two-finger horizontal gesture).

Impact
Breaks usability for all laptop users relying on touchpad scrolling.

Affects common workflows in editors like Vim, tmux, and less.

Regression compared to v1.23 Stable.

Workaround
Downgrade to Windows Terminal v1.23 Stable until a fix is released.

Actual Behavior
Vertical scrolling is frequently ignored or misinterpreted.

Some vertical gestures are incorrectly processed as WM_MOUSEHWHEEL events.

Applications inside the terminal (e.g., Vim, tmux) receive incorrect input, breaking usability.

Technical Analysis
Commit b53d7df introduced support for horizontal mouse wheel events by modifying the MouseWheel handler to interpret delta.X when delta.Y == 0.

Touchpads often emit gesture-based deltas that include small delta.X values even during vertical scrolling.

As a result, the terminal incorrectly treats vertical gestures as horizontal scroll events (WM_MOUSEHWHEEL).

Expected Behavior

No response

Actual Behavior

Enabled Scrolling (Mouse, Touchpad)

Originally created by @MicroDevX on GitHub (Sep 27, 2025). ### Windows Terminal version 1.24.2682.0 ### Windows build number 10.0.26220.0 ### Other Software _No response_ ### Steps to reproduce 🐛 Bug Report: Touchpad Scrolling Malfunction after Commit b53d7df Windows Terminal Version 1.24.2682.0 (Preview) Windows Build Number 10.0.26220.0 Commit Introduced b53d7df Add support for VT horizontal mouse wheel events Problem Description After upgrading to Windows Terminal Preview v1.24.2682.0, touchpad scrolling inside the terminal became unreliable: Vertical scrolling with two fingers on a touchpad often does not work. In some cases, scrolling works but behaves erratically (jumping, inconsistent speed, or misinterpreted as horizontal scroll). This issue was not present in v1.23 Stable. Steps to Reproduce Install Windows Terminal Preview v1.24.2682.0 on Windows build 10.0.26220.0. Open any terminal session (PowerShell, WSL, or CMD). Use a laptop touchpad to scroll vertically with two fingers. Observe that scrolling is either non-functional or inconsistent. Expected Behavior Smooth and consistent vertical scrolling using the touchpad, identical to behavior in v1.23. Horizontal scrolling should only trigger when explicitly performed by the user (e.g., two-finger horizontal gesture). Impact Breaks usability for all laptop users relying on touchpad scrolling. Affects common workflows in editors like Vim, tmux, and less. Regression compared to v1.23 Stable. Workaround Downgrade to Windows Terminal v1.23 Stable until a fix is released. Actual Behavior Vertical scrolling is frequently ignored or misinterpreted. Some vertical gestures are incorrectly processed as WM_MOUSEHWHEEL events. Applications inside the terminal (e.g., Vim, tmux) receive incorrect input, breaking usability. Technical Analysis Commit b53d7df introduced support for horizontal mouse wheel events by modifying the MouseWheel handler to interpret delta.X when delta.Y == 0. Touchpads often emit gesture-based deltas that include small delta.X values even during vertical scrolling. As a result, the terminal incorrectly treats vertical gestures as horizontal scroll events (WM_MOUSEHWHEEL). ### Expected Behavior _No response_ ### Actual Behavior Enabled Scrolling (Mouse, Touchpad)
claunia added the Needs-TriageIssue-BugNeeds-Attention labels 2026-01-31 08:48:17 +00:00
Author
Owner

@DHowett commented on GitHub (Oct 1, 2025):

Can you take a screen recording (with Snipping Tool) of the issue you are seeing?

@DHowett commented on GitHub (Oct 1, 2025): Can you take a screen recording (with Snipping Tool) of the issue you are seeing?
Author
Owner

@MicroDevX commented on GitHub (Oct 1, 2025):

Can you take a screen recording (with Snipping Tool) of the issue you are seeing?

Hello @DHowett, thank you for your response. I’d like to clarify that the touchpad scrolling issue happens only in Windows Terminal, while it works fine in other applications such as Visual Studio Code. Also, scrolling with a mouse works correctly — the issue is limited to the touchpad only. Regarding the video, unfortunately I’m not skilled in video editing, but I can try to provide a detailed description or screenshots if that would help.

https://github.com/user-attachments/assets/1b941f5c-8cb2-4488-ba08-6a0f8b8b4d44

@MicroDevX commented on GitHub (Oct 1, 2025): > Can you take a screen recording (with Snipping Tool) of the issue you are seeing? Hello @DHowett, thank you for your response. I’d like to clarify that the touchpad scrolling issue happens only in Windows Terminal, while it works fine in other applications such as Visual Studio Code. Also, scrolling with a mouse works correctly — the issue is limited to the touchpad only. Regarding the video, unfortunately I’m not skilled in video editing, but I can try to provide a detailed description or screenshots if that would help. https://github.com/user-attachments/assets/1b941f5c-8cb2-4488-ba08-6a0f8b8b4d44
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#23653