Repolode
Submit
petoncle

petoncle/mousemaster

Keyboard-driven mouse control and key remapping for Windows and macOS, with hint grids, UI hints and configurable combos.

Open-source alternative to:Vimium

View on GitHub
Stars
910
Forks
45
Open issues
17
Last commit
9 days ago

What is it?

mousemaster lets you move, click, scroll and drag the mouse pointer entirely from the keyboard, and remap keys on Windows and macOS. Behavior is defined in a single properties configuration file that reloads automatically when saved.

Navigation is handled by several modes: a labeled hint grid where typing a label jumps the cursor, a recursive grid that narrows the screen in 2x2 sections, labeled UI hints for buttons and fields in the active window, and zoom. Combos can be sequences, chords, timed holds or taps, and can be restricted to specific apps so the same keys act differently in different programs.

The project provides low-level building blocks such as modes, combos, commands, macros and key aliases, and ships several example configurations, including IJKL, WASD and HJKL layouts. On macOS it reads the keyboard through the Karabiner virtual HID device; Linux support is not yet available.

Key features

  • 01Move, click, scroll and drag the pointer from the keyboard
  • 02Hint grid and recursive grid navigation for precise cursor placement
  • 03UI hints that label buttons, links and text fields in the active window
  • 04Combos supporting key sequences, chords, holds and taps
  • 05Per-app behavior so the same keys do different things in different programs
  • 06Automatic reload of the configuration file on save

Use cases

  • Working on a laptop or split keyboard without reaching for the mouse
  • Reducing hand strain by keeping both hands on the keyboard
  • Customizing keyboard layouts with Vim-style or other navigation keys on Windows or macOS

Topics

#keyboard#mouse-control#keyboard-remap#accessibility#productivity#vim#windows#macos#ergonomic#keyboard-layout

FAQ

What is mousemaster?
Keyboard-driven mouse control and key remapping for Windows and macOS, with hint grids, UI hints and configurable combos. mousemaster lets you move, click, scroll and drag the mouse pointer entirely from the keyboard, and remap keys on Windows and macOS. Behavior is defined in a single properties configuration file that reloads automatically when saved.
Is mousemaster free to use? What license does it have?
mousemaster has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is mousemaster still maintained?
Actively maintained. The last commit to mousemaster was on Oct 13, 2026.
What can I use mousemaster for?
Working on a laptop or split keyboard without reaching for the mouse Reducing hand strain by keeping both hands on the keyboard Customizing keyboard layouts with Vim-style or other navigation keys on Windows or macOS
Where can I get mousemaster?
The source code and installation instructions are on GitHub: https://github.com/petoncle/mousemaster

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects