A native macOS menu-bar app that records keyboard and mouse actions, then plays them back.
Defaults
- Start / stop recording:
Ctrl Cmd J - Play back with edited delays:
Ctrl Cmd K - Play back in real time:
Ctrl Cmd L - Default delay:
0.3sbetween recorded actions
Use the menu-bar turtle icon to start recording, play macros, adjust Delay, and open Preferences. Preferences lets you customize the keyboard shortcuts.
Recording
KeyMouseRecorder records key presses, key releases, mouse clicks, and manual wait actions. Use Wait 5s while recording to insert an editable pause into the macro.
Use Select Picture to Click while recording to capture a screen region. During playback, the app screenshots the display, searches for that saved image, and clicks the matching location. The image matcher uses grayscale normalized cross-correlation with a coarse-to-fine search, which is more tolerant of brightness and color shifts than exact pixel matching.
Macros
Recent macros are saved to disk and shown in the menu. Non-favorite recent macros are limited to 99; favorites are protected and are not removed by that limit.
Use the heart button to favorite a macro. Favorited macros appear in the Favorites section below Recents.
Use the edit button to open the macro editor. Each action appears on its own row with an editable wait time. You can edit keys, click positions, and wait durations, delete rows, and drag rows to reorder them.
Build
Scripts/build-app.sh
The app bundle can be opened with:
open .build/app/KeyMouseRecorder.app
Permissions
macOS requires Accessibility and Input Monitoring permission for global key/mouse recording and playback. Screen Recording permission is required for Select Picture to Click and image matching. On first use, grant permission in System Settings, then relaunch the app if macOS asks for it.