Skip to content
trussoswPublic
forked from nilbuild/tinyhand

About

A tiny hand on a stick that points at things on your Mac screen.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

48 Commits

Folders and files

Repository files navigation

TinyHand

Latest release Platform: macOS License: MIT

A tiny hand on a stick that points at things on your Mac screen.

TinyHand: a tiny hand for your Mac

Download for macOS Visit website

macOS 13 or later, Apple Silicon and Intel.

Install

Open TinyHand.dmg, drag TinyHand to Applications and allow Accessibility when asked. It needs that to turn your clicks into taps. TinyHand updates itself.

Use

Click the menu bar icon, or ⌃⌥H Turn the pointer on or off
Right-click the menu bar icon Menu and Settings
Click Tap (nothing underneath gets clicked)
Hold and drag Draw on the screen
Hold ⌘ while drawing Add an arrowhead to the end of the line
⌃⌥X Clear the drawing
Esc Clear everything and turn the pointer off

While the pointer is on, a small toolbar at the bottom of the screen lets you pick one of 36 hands or a laser dot, mute the tap sound, or exit.

Automation

Launchers like Raycast or Alfred, and shell scripts, can control TinyHand with tinyhand:// links. Use open -g so TinyHand doesn't take focus:

open -g tinyhand://toggle
Link Action
tinyhand://on, tinyhand://off, tinyhand://toggle Turn the pointer on, off, or flip it
tinyhand://clear Clear the drawing
tinyhand://style/<id> Switch to a hand (or laser) and turn the pointer on
tinyhand://sound/on, /off, /toggle Tap sound for the current pointer

While TinyHand runs, it keeps its current state in ~/Library/Application Support/TinyHand/state.json: whether the pointer is on, the selected style, whether sound is on, and every style with its id, name and type (hand, custom or laser). The file is removed when TinyHand quits. It also records the app's pid, so a file left behind by a crash can be detected.

If TinyHand isn't running, opening any link launches it and then runs the command.

License

MIT. See LICENSE.

About

A tiny hand on a stick that points at things on your Mac screen.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages