- A keyboard driven interface for mouseless mouse manipulation
- Heavily inspired by warpd and mouseable
Demo • Installation • Features • Notes
mousemaster-demo.mp4
mousemaster-grid.mp4
java_RLSRtDqcg0.mp4
mousemaster-mouse-movements1.mp4
mousemaster-mouse-movements2.mp4
- Download mousemaster.exe (a portable executable) from the Release page, or build it from source.
- In the same Release page, choose then download one of the existing configuration files:
- neo-mousekeys.properties (recommended): a WASD configuration (see documentation)
- warpd.properties: an HKJL configuration (see documentation)
- mouseable.properties: another HKJL configuration (see documentation)
- author.properties: an IJKL based 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.
- 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.
- If you enjoy mousemaster, consider making a donation or stop by the Discord to show your support!
- Advanced key combinations (key combos): mousemaster offers a high level of customization for key combinations. It allows for advanced key combos like "hold alt for 1 second" or "press then release alt, twice in a row".
- Custom modes: Users have to define their own modes, with each mode having its own key combo-to-command map and mouse settings. There is only one predefined mode, the "idle-mode", which has no key combos predefined (this is the "mousemaster is disabled mode").
- Flexible key combo to command mappings: The same key combo can be used to trigger multiple commands. Multiple key combos can be used to trigger the same command.
- Multi-screen navigation: mousemaster allows for mouse movement across multiple screens.
- Grids: mousemaster includes a grid-based navigation system. A grid can cover the active screen or the active window.
- Hints: mousemaster includes a hint-based navigation system similar to Vimium's. A hint grid can cover the active screen, the active window, or all screens (which can be used for screen selection hints). A mouse button click can be automatically triggered after a hint is selected.
- Dynamic configuration: The configuration file is live, mousemaster automatically reloads it whenever the file is saved.
- Visual mouse indicator: The optional and customizable mouse indicator (a plain-color square drawn next to the mouse cursor) changes colors based on mouse activity—idle, moving, button pressing, or scrolling. It repositions itself to stay visible when the mouse is near screen edges.
- Left/right key distinction: mousemaster distinguishes between left and right alt/ctrl/shift keys, meaning that left alt and right alt can be used to trigger different commands.
- Position history hints: absolute positions can be saved on the fly to make it possible to move the mouse to them later.
- I use mousemaster on a daily basis, along with PowerToys and the Tridactyl extension for Firefox. I no longer use my physical mouse except for some certain tasks like drawing.
- The two major differences between mousemaster and the existing alternatives (warpd and mouseable), are the way key combos are defined (i.e. the distinction between key presses and key releases), and the "create your own modes" approach.
- The configuration of mousemaster is significantly more complex than warpd and mouseable, mostly because you have to think in terms of key presses and key releases. This is a conscious trade-off for greater flexibility.
- Currently, mousemaster is Windows-only. I have not looked at making it cross-platform only because my desktops are Windows based.
- If you need help, have questions, or suggestions, don't hesitate to open a GitHub Issue or join the Discord.
