Hyperpoint is a macOS menu bar app that remaps mouse buttons, makes the scroll wheel glide and turns Caps Lock into a hyper key. Every setting goes back on the moment a device wakes or reconnects.
Download for MacSigned and notarized by Apple 1.2 MB download macOS 27 on Apple silicon
Why it exists
~/.config/hyperpoint/config.json, for every mouse and keyboard you use.Press the button
you want to change.
Hyperpoint makes the rule
and keeps it through
every sleep and reconnect.
What it does
The mouse and Caps Lock setup you had in BetterMouse and Karabiner, made by pressing buttons instead of looking up key codes.
Reconnected at . Every setting written back.
When a mouse wakes or reconnects, Hyperpoint writes every setting back: the gesture and top buttons, the thumb wheel, smooth scrolling and the hyper key. The menu shows when it last did.
Hold Caps Lock and every key you press gets Control, Option, Shift and Command, ready for app shortcuts. Pick the keyboards it works on, or switch it off everywhere from the menu bar.
Each wheel step becomes an eased pulse. How far it goes depends on how fast you spin, on a speed curve you drag into shape. The shaded bands are an MX wheel's real speeds, measured.
Click Add Rule and press the button, key or thumb wheel. Hyperpoint makes the rule for that control, then you pick what it does: Mission Control, App Exposé, a Space, any shortcut or a held modifier.
Hold a button and move the mouse to scroll, with momentum. The MX Master 3 preset puts it on the right button, and a quick press still clicks.
Keys a mouse sends, like the number keys a Razer Naga's side buttons type, can become modifiers or shortcuts. A modifier is mapped below apps, so it holds in password fields too.
See each device's state, apply settings again, pause everything or open the config file, all from one menu.
How it works
Drag Hyperpoint into Applications and open it. Turn on Accessibility and Input Monitoring in System Settings. Until you do, the menu says Needs attention and nothing changes.
Every keyboard and mouse you plug in shows up under Devices. Start it from a preset for its model, copy another device's settings or start empty. Click Ignore and Hyperpoint leaves it alone.
Click Add Rule, press the button on your mouse and choose what it does. From then on, Hyperpoint keeps it in place through every sleep, wake and reconnect.
Proof
This is the config from the Mac Hyperpoint was built on. Two mice and two keyboards, each set up from a preset, replacing a BetterMouse and Karabiner setup. The settings window edits this file and nothing else, so every setting can be read, diffed and backed up.
~/.config/hyperpoint/config.jsonExcerpt, scrolling settings left out{
"version": 1,
"hyper": { "key": "capsLock", "onTap": "nothing" },
"devices": [
{
"match": { "vendor": "0x046D", "product": "0xB023" },
"name": "MX Master 3",
"rules": [
{ "control": { "hidpp": "0xC3" }, "when": "click", "do": "missionControl" },
{ "control": { "hidpp": "0xC3" }, "when": "holdMoveDown", "do": "appExpose" },
{ "control": { "hidpp": "0xC4" }, "when": "click", "do": { "shortcut": "shift+cmd+4" } },
{ "control": "thumbWheel", "when": "scroll", "do": "reverse" },
{ "control": { "button": 1 }, "when": "holdMove", "do": "scroll" }
]
},
{
"match": { "vendor": "0x1EA7", "product": "0x0002" },
"name": "2.4G Mouse",
"kind": "mouse",
"rules": [
{ "control": { "key": "escape" }, "when": "hold", "do": { "modifier": "rightOption" } },
{ "control": { "key": "return" }, "when": "click", "do": { "shortcut": "opt+shift+s" } }
]
},
{ "match": { "builtIn": true }, "name": "Built-in Keyboard", "hyper": true },
{ "match": { "vendor": "0x004C", "product": "0x0321" }, "name": "Magic Keyboard", "hyper": true }
],
"ignored": []
}FAQ
The short answers. The README on GitHub has the long ones.
macOS 27 on Apple silicon. Download the DMG from the latest release, open it and drag Hyperpoint into Applications.
The download is 1.2 MB, and the app takes 3.3 MB once installed. It is one native Apple silicon binary with no bundled frameworks or runtime.
Yes. Every keyboard and mouse Hyperpoint sees shows up under Devices. Logitech mice that speak HID++ get their gesture and top buttons and the thumb wheel. Other mice get their plain buttons and any keys they send. Trackpads stay as macOS has them.
That is the problem Hyperpoint was built for. On every wake and reconnect it writes the full setup back to the mouse, and the menu shows when the mouse reconnected and that its settings were applied again.
Not for what Hyperpoint covers: button rules and gestures, smooth scrolling, hold to scroll, the hyper key and remapping keys a mouse sends. Karabiner can also rewrite any key on any keyboard with complex rules. If you rely on those, keep it for them.
Yes. Install the Hyperpoint config skill in Claude Code, then ask for what you want, like "make the gesture button open App Exposé". It knows every rule the app enforces, checks the edit before saving it and reads the app's log to confirm it took.
Accessibility lets the hyper key and smooth scrolling change keys and scrolls as they happen. Input Monitoring lets Hyperpoint set up the buttons on Logitech mice. Until both are on, the menu says Needs attention and nothing is applied.
No. The app has no network code at all. Your settings live in one file on your Mac, and the log of what it did stays on your Mac too.
In ~/.config/hyperpoint/config.json. The settings window edits that file and nothing else, so you can edit it by hand too. A file with an error is rejected whole, with the path of the mistake, and the last good settings keep running.
Hyperpoint clears the key mappings it made, so Caps Lock and your mouse keys go back to how macOS had them. To stop it for a while without quitting, choose Pause Hyperpoint from the menu.
Choose Quit Hyperpoint from the menu and drag the app to the Trash. To remove your settings as well, delete the ~/.config/hyperpoint folder.
Version 0.1.0 came out before releases were notarized. Download 0.1.1 or later, or allow 0.1.0 under System Settings › Privacy & Security › Open Anyway.
A fresh install changes nothing until you set up a device, and quitting puts your keys back. Try it on the mouse you already have.
Download for MacSigned and notarized by Apple 1.2 MB download macOS 27 on Apple silicon
