Hinto

Keyboard-driven UI navigation for macOS

Navigate any macOS app without a mouse using accessibility labels.

---

Features

• Click Mode: Press Cmd+Shift+Space to show labels on clickable elements
• Scroll Mode: Press Tab to switch to scroll mode with vim-like keys (H/J/K/L)
• Configurable Labels: Choose label size (S/M/L) and theme (Dark/Light/Blue)
• Auto-click: Automatically click when an exact label match is typed

Installation

Build from Source

See CONTRIBUTING.md for development setup.

cd Hinto
make setup  # First time only: create code signing certificate
make run

Requirements

• macOS 13.0+
• Xcode 15.0+
• Accessibility Permission (required for global hotkeys)

Usage

1. Press Cmd+Shift+Space to activate
2. Type the label of the element you want to click
3. Press Enter to confirm, or wait for auto-click
4. Press Shift+Enter for right-click
5. Press Tab to switch to scroll mode
6. Press Escape to cancel

Scroll Mode Keys

Key	Action
J	Scroll down
K	Scroll up
H	Scroll left
L	Scroll right
D	Half page down
U	Half page up
Shift+J/K/H/L	Fast scroll

Configuration

Access settings via the menu bar icon:

• Label Theme: Dark, Light, or Blue
• Label Size: Small, Medium, or Large
• Auto-click: Enable/disable automatic clicking on exact match

Troubleshooting

Hotkey not working

1. Check System Settings > Privacy & Security > Accessibility
2. Add Hinto.app and ensure it's checked
3. Restart the app after granting permission

Check logs

make log
# or
tail -f /tmp/hinto.log

License

MIT