Skip to content

Tap Shift to switch between the hand and the mouse - #15

Open
alcibiadesc wants to merge 2 commits into
nilbuild:mainfrom
alcibiadesc:shift-tap-mouse-mode
Open

alcibiadesc wants to merge 2 commits into
nilbuild:mainfrom
alcibiadesc:shift-tap-mouse-mode

Conversation

@alcibiadesc

@alcibiadesc alcibiadesc commented Nov 7, 2026 •

Copy link
Copy Markdown

Holding ⌥ to click for real works for a quick click, but for a longer stretch of real work (typing in a field, dragging a window, scrolling a page) holding a key gets tiring. This adds a latched mode.

What it does

  • Tap the switch key on its own → mouse mode: clicks, drags and scrolls reach the app and the normal cursor comes back (or the hand stays, following the existing While holding setting). Tap again → back to the hand.
  • The menu bar icon turns orange while mouse mode is on; a short hint at the bottom says which mode you're in (optional, see below).
  • New setting Settings → Mouse mode → Tap to switch: ⇧ Shift (default), ⌥ Option, ⌘ Command, ⌃ Control or Off.
  • Settings → Mouse mode → Show a hint when switching (on by default) turns that hint off for people who only want the orange icon.
  • Turning the pointer off always resets to the hand.

What counts as a tap
Pressed and released alone within 400 ms, with no other key, modifier or mouse button in between — so typing capitals or using ⇧-shortcuts never switches. The event tap now also listens (pass-through only) to flagsChanged and keyDown while the pointer is on; nothing is swallowed.

🤖 Generated with Claude Code

alcibiadesc and others added 2 commits November 7, 2026 15:50
Tapping the switch key on its own (Shift by default, configurable in
Settings → Mouse mode, or Off) latches a mouse mode: clicks, drags and
scrolls reach the app until the key is tapped again. A tap only counts
when the key is pressed and released alone within 400 ms, with no other
key, modifier or click in between, so typing capitals never switches.
The menu bar icon turns orange while mouse mode is on, and a short hint
says which mode is active. Turning the pointer off resets to the hand.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Settings → Mouse mode gets a toggle, on by default, for the short
message that says whether clicks are taps or reach the app.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant