VimMouse

📖 中文版文档请见：README.zh-CN.md

Control the cursor with your hands on the keyboard’s home row — even if you don’t have a ThinkPad.

🎯 This project is based on EsportToys/TPMouse.
Many thanks to the original author for their great work!

Improvements in This Version

• ✅ Keybindings optimized for Vim users.
• ✅ Tweaked cursor and scroll speed for smoother control.
• ✅ Grid mode now supports multi-monitor environments for precise positioning across screens.

🔧 Requirements

To run VimMouse, you need to install the following:

• AutoIt3
• SciTE4AutoIt3

These tools are required to run, compile, and debug the .au3 scripts that power VimMouse.

---

Inertia Mode

1. Activate with `I (Backtick + I).
2. Move the cursor using H / J / K / L:
   • H: Left
   • J: Down
   • K: Up
   • L: Right
3. Hold S to brake for more precise movement.
   Hold Space to scroll horizontally/vertically.
4. Click with:
   • A: Left Click
   • D: Right Click
   • W: Middle Click
5. Exit with `O (Backtick + O) or Esc.

---

Grid Mode

1. Activate with `P (Backtick + P).
2. A red grid overlay will appear. Use H/J/K/L to narrow down the search area.
3. Click with A (left), D (right), or W (middle).
4. press 0,1,2... to focus on different monitor.
5. Exit with `O or Esc.

🆕 Multi-monitor support: Use number keys (0–9) to quickly switch and target grid mode on a specific screen. The grid will automatically snap to that monitor.

---

Demo Videos

Inertia Mode

inertia.mp4

Grid Mode

grid.mp4

---

Configuration: options.ini

You can customize keybindings and inertia parameters via the options.ini file. If the file is missing, the script falls back to these defaults:

[Inertia]
DampingCoef=15
BrakingCoef=90
NormalSensitivity=1
ScrollSensitivity=1

[Bindings]
up=VK_K
left=VK_H
down=VK_J
right=VK_L
mb1=VK_A
mb2=VK_D
mb3=VK_W
brake=VK_S
scroll=VK_SPACE