Repository navigation
Releases
Clavimo 1.3.1
Changed
- The action compass draws one segment per action, as large as the area that picks it: with two actions each one gets half of the ring, with four a quarter. Directions without an action are no longer drawn, so you see at a glance how much room every action has.
Install
Download Clavimo-1.3.1.zip, unzip it and move Clavimo to Applications. Clavimo is not notarized by Apple, so the first launch of each version needs one extra confirmation in System Settings > Privacy & Security ("Open Anyway"). See the first launch guide.
SHA-256: f0189039a5717de17b400fc6772350aaaf3200ddfbda6d694e28cb376179025c
v1.3.0
Action compass
Up to eight actions around the pointer. Hold a key or a mouse button, move towards an action and let go: it runs at once, without aiming. After a moment the compass shows its actions and highlights the one that will run.
- Tap instead of holding to keep the compass open as a panel: click an action, press 1 to 8, or press Esc. A trackpad gesture or the menu bar opens it the same way.
- Pages for apps: each app can have its own actions in some directions; the others stay the same everywhere.
- Nested compasses: a direction can open another compass in the same place.
- Templates: Spaces and windows, music and volume, browsers, Visual Studio Code and Cursor, Zoom.
- Any menu item as an action, also for commands without a shortcut, picked from the app's menus in the editor.
- Configurable by an AI assistant: compasses are part of the configuration file, so ChatGPT or Claude can write one and you paste it with Rules > Paste Rules.
Open Settings > Compass to start.
Also new
- Side mouse buttons (3 and up) can run an action on their own, without a modifier.
- The configuration file keeps top-level fields this version does not know when it is saved.
Notes
- Versions before 1.3.0 drop compasses when they save the configuration.
- While a rule opens a compass, left and right clicks pass through Clavimo so a click can pick or close it. Pointer movement is still never observed by the event tap; the pointer position is read only while a compass is open.
Install
Download Clavimo-1.3.0.zip, unzip it and move Clavimo to Applications. Clavimo is not notarized by Apple, so the first launch of each version needs one extra confirmation in System Settings > Privacy & Security ("Open Anyway"). See the first launch guide.
SHA-256: 19abfefb81a1231cb21f2ee4b09cc44445d82b87aa16d8f652259dcd81ab1864
v1.2.4
Added
- Paste Rules, in Rules and in General > Backup and Import: paste rules an AI assistant wrote, or any Clavimo rules in JSON, without saving a file. One long JSON or several separate rules pasted one after another are accepted (a whole configuration, lists of rules or single rules), also inside Markdown code blocks. Missing IDs, names and profiles are filled in, and every change is shown before it is applied.
Fixed
- Only one copy of Clavimo runs at a time. Two copies each ran every rule, so a key or gesture could act twice; a second launch now quits and leaves the running copy in charge.
Install
Download Clavimo-1.2.4.zip, unzip it and move Clavimo to Applications. Clavimo is not notarized by Apple, so the first launch of each version needs one extra confirmation in System Settings > Privacy & Security ("Open Anyway"). See the first launch guide.
SHA-256: 757caf8e5f013d251f3e4194610ae017f48a542f6670c9b8ba332a617de412cc
Clavimo 1.2.3
First public release of the 1.2 features below.
Added
- German interface.
- Turn two fingers like a knob: clockwise and counterclockwise are gestures of their own, and every further 15 degrees runs the action again, so volume or brightness change smoothly. Trackpad scrolling is held still while fingers turn.
- Trackpad zones: a gesture can do different things on the left, right, top or bottom half of the trackpad, or in one of its corners. A rule for a zone wins over the same gesture anywhere.
- Trackpad templates for volume and brightness by turning two fingers.
Fixed
- Clavimo 1.2.0 quit right after launch while checking keyboards for a leftover Caps Lock mapping, and its Keyboard pane was missing from the settings sidebar. Versions 1.2.0 to 1.2.2 were tagged but never published.
- Turning two fingers starts only when both fingers move around a center, so a resting thumb or a curved two-finger scroll no longer changes the volume by accident.
Also in this release (tagged as 1.2.0, never published)
Added
- Keyboard pane with Caps Lock choices (Escape, or Escape when tapped and Control or Hyper when held, with Caps Lock on a double tap), home row modifiers, templates and all keyboard rules.
- Tap or hold any key: one output when tapped, another when held, an optional double tap, and a tap output for modifier keys pressed alone. Misfire protection for letter keys: a key of the same hand or fast typing means tap.
- Layers, turned on while a key is held or switched on and off, with the active layer next to the menu bar icon.
- Combos (two or three keys pressed at the same moment), key sequences after a leader key with an on-screen list of the next keys, and one-shot modifiers.
- Keyboard outputs: a key held as long as its trigger, a shortcut, modifiers, a layer, a one-shot modifier, a sequence start, any action, or nothing.
- Caps Lock as a rule trigger. Clavimo moves Caps Lock to F18 at the keyboard level while such rules run and restores it when remapping stops or Clavimo quits.
- Condition on the keyboard input source, and the
toggleCapsLockaction. - The menu and the Keyboard pane say when secure typing (a password field) pauses keyboard rules, and which app turned it on.
- Japanese keyboard keys (英数, かな) in key pickers;
clavimo-probe keyboardlists input sources and secure typing.
Changed
- Modifiers held by keyboard rules (for example a home row ⌘) count for modifier + mouse button rules and trackpad rules.
Clavimo 1.1.1
Clavimo 1.1.1 brings the trackpad into your rules.
New
- Trackpad gestures: taps with 2-5 fingers, tip taps beside a resting finger, and swipes with 3-5 fingers, optionally while holding a key such as Fn, and limited to apps if you like.
- Trackpad clicks: click with 3-5 fingers, or click or tap in a corner, to run an action. A three-finger tap or click makes a great middle click.
- Trackpad scrolling, separate from the mouse: reverse each axis, change the speed, or turn momentum off. macOS has one natural scrolling switch for both; now each can go its own way.
- New actions for every rule: click a mouse button, send a keyboard shortcut, open an app, or press media and volume keys.
- Trackpad pane: a live drawing of your fingers that names each recognized gesture and the rule it runs, ten templates, and warnings when a macOS gesture uses the same movement.
Gestures are experimental. Like other gesture tools, Clavimo reads finger positions through Apple's private MultitouchSupport framework, only while a trackpad rule is on or the Trackpad pane is open, and never stores them. If a macOS update changes that framework, gestures turn themselves off and everything else keeps working.
Not notarized by Apple. After the first launch, open System Settings > Privacy & Security and click Open Anyway. Updating from 1.0 keeps your permissions.
Full list: CHANGELOG.md. Check the download with shasum -a 256 Clavimo-1.1.1.zip against the attached .sha256 file.
Clavimo 1.0.0
Clavimo 1.0: keyboard and mouse rules for macOS, with a redesigned app, an English and Polish interface, and smooth scrolling.
Features marked Experimental in the README are complete and covered by automated tests but have not yet been verified on real hardware.
Not notarized by Apple. After the first launch, open System Settings > Privacy & Security and click Open Anyway. Details in the README.
New since 0.1.0
- Redesigned settings window: Overview, Rules, Mouse & Scrolling, Devices, Diagnostics, General and About. Rules are drawn as keycaps, mouse buttons and actions, and explained in a sentence.
- New app icon and menu bar icon.
- First-launch guide for permissions, devices and a first rule from templates.
- Rule templates and a live preview in the rule editor.
- Profiles that inherit the Default rules, switched from the menu bar.
- Export, import with a preview of the changes, and restoring the previous configuration.
- Diagnostics: event tap health, processing time, an opt-in input inspector kept in memory only, and a diagnostic report without typed text.
- Pause for 5 minutes or 1 hour.
- Mouse wheel scroll modes per axis, including smooth scrolling.
- Polish interface (follows the macOS language).
- Keyboard and VoiceOver support in the rules list.
Full list: CHANGELOG.md. Check the download with shasum -a 256 Clavimo-1.0.0.zip against the attached .sha256 file.
Clavimo 0.1.0 (preview)
First preview release of Clavimo, a native macOS menu bar app for keyboard and mouse rules.
This is a pre-release. Most features are experimental: they are covered by automated tests but have been verified on only one Mac (macOS 27.2, Apple Silicon). Please report what works and what does not on your hardware.
Highlights
- Swap or remap keys, including left and right Command and Option separately.
- Modifier + mouse button and letter key + mouse button shortcuts for switching Spaces, Mission Control and application windows.
- Reverse the mouse wheel without changing trackpad scrolling.
- Rules limited to apps, or (experimental) to one keyboard or mouse.
- Visual rule editor with key recording, pause and emergency disable, optional Launch at Login.
See the changelog for details.
Install
- Download
Clavimo-0.1.0.zip, unzip it and move Clavimo.app to Applications. - Open it. macOS says Apple could not verify the app: this release is not notarized by Apple. Click Done.
- In System Settings > Privacy & Security, click Open Anyway next to the Clavimo message and confirm.
- Grant Accessibility and Input Monitoring when asked.
Requirements: macOS 14 or later. Universal build (Apple Silicon and Intel); Intel has not been tested.
SHA256 (Clavimo-0.1.0.zip): 4a99a4eec478acf8c74f13bb97df03c9220dd1a487e32a382e8564ea338a978f