Skip to content

Add pointer mode: clicks work as usual, hold ⌥ to present - #44

Open
jorgenbruntveit wants to merge 2 commits into
nilbuild:mainfrom
jorgenbruntveit:pointer-mode
Open

jorgenbruntveit wants to merge 2 commits into
nilbuild:mainfrom
jorgenbruntveit:pointer-mode

Conversation

@jorgenbruntveit

@jorgenbruntveit jorgenbruntveit commented Nov 18, 2026 •

Copy link
Copy Markdown

Adds a pointer mode for people who want the hand on screen all the time, as their everyday cursor, and only present now and then.

What it does

  • Settings → General → Clicks → When the pointer is on: Tap and draw (today's behaviour, the default) or Work as usual. With Work as usual, clicks, drags and scrolls reach apps while the hand stays on screen. Hold ⌥ (the interact key) to tap and draw, and let go to get normal clicks back.
  • The interact key flips the current mode. Holding it while clicks go through now taps, so the same key works both ways. This also applies to double-tap ⇧ click-through: before, holding ⌥ there still clicked through.
  • Double-tap ⇧ switches away from whichever mode the pointer started in, and the menu bar icon turns orange while it is switched.
  • In pointer mode the hand stays over the menu bar and open menus, right-click menus included, as it does with Keep the hand. Esc doesn't turn the pointer off, and the pointer comes back by itself after sleep, a lock, or closing Settings.
  • Settings → General → Startup → Turn the pointer on when TinyHand opens, off by default.
  • The first-run and mode hints describe the active mode.

How

  • New Preferences.pointerMode and Preferences.turnOnAtLaunch, cleared by Reset.
  • InputTap treats a press as an interact press when keyHeld != clickThrough. Pointer mode starts with clickThrough on.
  • OverlayController keeps a presenting flag for the Dock mouse catch, adds isLatched for the orange icon, and turns the pointer back on after com.apple.screenIsUnlocked or a wake, if a lock or sleep turned it off in pointer mode and the screen is not locked.
  • updateZones treats pointer mode like Keep the hand when choosing between the hand and the real cursor.
  • SettingsWindow.onClose lets AppDelegate turn the pointer back on after Settings, when it was on in pointer mode.

Testing

Built with swift build -c release and used locally on macOS 27.3 as the everyday cursor, with ⌥ to draw. I didn't run --e2e-test, because it drives the real mouse.

Nothing changes for existing users unless they choose Work as usual, apart from the ⌥-while-click-through change above.

🤖 Generated with Claude Code

jorgenbruntveit and others added 2 commits November 18, 2026 10:57
A new setting makes the hand the everyday cursor. Clicks reach apps
while the pointer is on, and holding the interact key taps and draws.
Holding the key now flips whichever mode is active, so it also taps
while double-tap Shift click-through is latched.

In pointer mode Esc stays free, and the pointer comes back after
sleep, a lock or Settings. A separate setting turns the pointer on
when TinyHand opens.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
In pointer mode the hand is the cursor, so switching to the system
cursor over the menu bar and open menus, right-click menus included,
made it vanish exactly where people point at things. It now stays, as
it already does with Keep the hand.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
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