- Control your mouse from the keyboard and remap your keys
- Heavily inspired by warpd, mouseable, neru and kanata
Demo • Installation • Usage • Features • Contributing
mousemaster-demo.mp4
mousemaster-neru-recursive-hint-grid.mp4
mousemaster-neru-ui-hints.mp4
mousemaster-grid.mp4
mousemaster-mouse-movements1.mp4
- Download mousemaster.exe (a portable executable) from the Release page, or build it from source.
- In the same Release page, choose and download one of the existing configuration files:
- neo-mousekeys-ijkl.properties (recommended): an IJKL configuration (see documentation)
- neru.properties: a recursive hint configuration (see documentation)
- neo-mousekeys-wasd.properties: a WASD configuration (see documentation)
- warpd.properties: an HKJL configuration (see documentation)
- mouseable.properties: another HKJL configuration (see documentation)
- author.properties: an IJKL configuration designed to control everything with the right hand only (see documentation)
- Place the executable and the configuration file of your choice in the same directory.
- Rename the configuration file to mousemaster.properties.
- Run mousemaster.exe: make sure to run it as administrator if you want the mousemaster overlay to be displayed on top of everything else.
- Feel free to open a GitHub Issue or join the Discord if you need help creating your own configuration. If you have ideas for a better configuration that you would like to share, I'd love to hear from you.
The recommended configuration uses the following key bindings:
- Activate: Press leftalt + e or leftalt + capslock
- Deactivate: Press q or p
- Mouse movement: Use i (up), j (left), k (down), l (right)
- Mouse buttons: ; (left), rightshift (middle), ' (right)
- Grid mode: Press g
- Hint mode: Press f
- UI Hint mode: Press leftalt + f
- Screen selection: Press c
For a complete reference, see the neo-mousekeys-ijkl documentation.
- Combos and key remapping: Define combos (key sequences, chords, timed holds, taps, tap-dances, and more) to trigger commands, switch modes, or remap keys. See the combo reference.
- Modes: Each mode has its own combos and its own hint, grid, indicator and zoom settings, and can inherit properties from other modes.
- Continuous mouse movement: Move the cursor, click, scroll, and drag, all from the keyboard.
- Hint navigation: Cover the screen with a grid of labeled hints, type a label to jump the cursor there.
- UI hint navigation: Label buttons, links, and text fields in the active window.
- Recursive grid navigation: Divide the screen into 2x2 sections, shrink with each key press or snap to the grid's edges to reach a precise position.
- Zoom.
- App-specific behavior: Restrict combos to specific apps, so the same keys behave differently depending on the focused app.
- Cursor indicator: Custom shape, color, outline, shadow, text label, changes per mouse state.
- Position history: Save cursor positions, jump back to them later.
- Live configuration: All configuration lives in a single file that is automatically reloaded when saved.
mousemaster provides low-level primitives (modes, combos, commands, macros, key aliases) that you compose to build the exact behavior you want. See the configuration reference.
Contributions to mousemaster are welcome!
-
Share a configuration: If you have ideas for a new or improved configuration that you would like to share, open an issue or join the Discord.
-
Cross-platform support: mousemaster currently supports Windows only. That said, the overlay has already been reimplemented to be cross-platform. The remaining work is keyboard/mouse input handling and sending inputs on macOS and Linux.
If you're interested in helping extend mousemaster to these platforms, your contributions are very welcome. Please open an issue or join the Discord to get involved.
If you enjoy mousemaster, consider making a donation or stop by the Discord to show your support!