Upgrade StoragePDF reader jitters 1px continuously when MX Master 3S pointer hovers the page
Environment
- Zotero 10.0.3-beta.3+80bc5565e. I haven't yet tested whether this reproduces on current stable.
- macOS Golden Gate 27.0, Apple Silicon
- Logitech MX Master 3S, firmware 22.1.6, connected over Bluetooth
Description
With an MX Master 3S connected over Bluetooth, the PDF reader oscillates vertically by exactly one pixel, continuously. The page never actually scrolls: it shakes in place.
The jitter continues regardless of pointer position, including with the pointer parked far from the Zotero window, and regardless of which application has focus. It does not stop when the mouse is left untouched. It stops only when the mouse is disconnected or bluetooth turned off.
Frame-by-frame analysis of a screen recording shows an alternating ±1px vertical shift, with an occasional 1px horizontal component.
Steps to reproduce
1- Connect an MX Master 3S (or similar high-resolution scroll mouse) over Bluetooth
2- Open any PDF in the reader
3- Leave the mouse untouched, pointer anywhere on screen (over Zotero or not)
4- The page begins oscillating by 1px and continues indefinitely
Notes on scope
Does not occur in the My Library view, presumably because there is nothing scrollable in that state.
What this isn't
- Not the mouse hardware: no jitter in Preview, or in Firefox's own pdf.js viewer with the same mouse, or on ordinary Firefox pages
- Not the Logitech driver: problem reproduces with Logi Options+ killed, removed from login items, and after a reboot
- Not the scroll wheel encoder: unaffected by switching the wheel between ratchet and free-spin mode, or by flicking the thumb wheel
- Not visible as input events: a session-level CGEventTap listening on kCGEventScrollWheel logs nothing at all while the jitter is happening, which suggests the oscillation originates inside the compositor rather than from incoming scroll events
Workaround
Setting `general.smoothScroll` to `false` in the Config Editor stops it completely.
- Zotero 10.0.3-beta.3+80bc5565e. I haven't yet tested whether this reproduces on current stable.
- macOS Golden Gate 27.0, Apple Silicon
- Logitech MX Master 3S, firmware 22.1.6, connected over Bluetooth
Description
With an MX Master 3S connected over Bluetooth, the PDF reader oscillates vertically by exactly one pixel, continuously. The page never actually scrolls: it shakes in place.
The jitter continues regardless of pointer position, including with the pointer parked far from the Zotero window, and regardless of which application has focus. It does not stop when the mouse is left untouched. It stops only when the mouse is disconnected or bluetooth turned off.
Frame-by-frame analysis of a screen recording shows an alternating ±1px vertical shift, with an occasional 1px horizontal component.
Steps to reproduce
1- Connect an MX Master 3S (or similar high-resolution scroll mouse) over Bluetooth
2- Open any PDF in the reader
3- Leave the mouse untouched, pointer anywhere on screen (over Zotero or not)
4- The page begins oscillating by 1px and continues indefinitely
Notes on scope
Does not occur in the My Library view, presumably because there is nothing scrollable in that state.
What this isn't
- Not the mouse hardware: no jitter in Preview, or in Firefox's own pdf.js viewer with the same mouse, or on ordinary Firefox pages
- Not the Logitech driver: problem reproduces with Logi Options+ killed, removed from login items, and after a reboot
- Not the scroll wheel encoder: unaffected by switching the wheel between ratchet and free-spin mode, or by flicking the thumb wheel
- Not visible as input events: a session-level CGEventTap listening on kCGEventScrollWheel logs nothing at all while the jitter is happening, which suggests the oscillation originates inside the compositor rather than from incoming scroll events
Workaround
Setting `general.smoothScroll` to `false` in the Config Editor stops it completely.