SuperKeyboard

AutoHotkey script with Vim (and now also WASD!) bindings to control the mouse with the keyboard

Why use a mouse control script?

This is my implementation of a hardware mouse, in software. As of 2023 I believe it has full feature parity with an actual mouse, and has been optimized by daily use for several years. Whatever your reasons for trying to drive the mouse with the keys, this is my very best attempt at creating a program to do so, and I hope you find it as pleasant and convenient to use as I do.

Installation

Download the script and binary by cloning this repository from GitHub. The command to run is

git clone https://github.com/everdom/SuperKeyboard.git

If that sentence makes no sense to you at all, no worries! Simply download the repository as a zip file, unzip it, and run the included executable SuperKeyboard.exe :>

The benefit to using git is you can keep up to date with git pull. I'm still (periodically) pushing little updates here and there to make it better and easier to use.

Precompiled Binary

As of the latest release, a precompiled version is shipped with the source code so you don't have to install anything at all. Just double click the .exe and you're gucci golden! (It's the one with a cute little mouse icon) (Well, I think it's cute; I'm not much of an artist, admittedly)

Running from Source

You should run this script from source; never trust binaries you just find lying around on the Internet, even if it's from a trustworthy source like yours truly :^)

To run it you'll need to install AutoHotkey first. Then you should be able to double click the .ahk file to run the script. Pretty easy right?

AS OF (WHENEVER IT WAS) AHK has updated to "Version 2.0"

Luckily it turns out, you can install either version 1.1 or 2.0, as when you try to run SuperKeyboard.ahk in Version 2, it will happily download the old version and run it appropriately.

Modes of Input

This program has modes of input, allowing the keys to sometimes drive the mouse, and sometimes drive the keyboard (inspired by the text editor Vim). There's "Insert mode" where the keys behave normally and "Normal mode" intercepting keys to move and control the mouse instead. (These names are lifted from Vim. I'm aware, "Normal" mode isn't very normal at all)

Win Alt n enters Normal mode Win Alt i enters Insert mode Win Alt p enters Numpad mode Win Alt c toggle Chrome vim mode

Modifier hint

^=ctrl !=alt +=shift #=win

Normal mode

• hjkl move the mouse
• HJKL jump to edges of the current window
• M jump to center of the current window
• m jump to center of the current screen
• i left click
• o right click
• p middle click
• v hold down left click (hit v or any mouse button again to release)
• c hold down middle click (hit c or any mouse button again to release)
• x hold down right click (hit x or any mouse button again to release)
• ; scroll down (support modifier)
• ' scroll up (support modifier)
• : page down
• " page up
• [ home
• ] end
• d, page down(vim mode)
• u, e page up(vim mode)
• , "min" a window (move to the min button of window) (press i to click)
• . "max" a window (move to the max button of window) (press i to click)
• / "close" a window (move to the close button of window) (press i to click)
• Backspace "back" a window (move to the back button of window) (press i to click)
• Y "yank" a window (reposition it) (press i or v to release)
• Z "resize" a window (press i or v to release)
• < move to the center of left screen
• > move to the center of current screen
• ? move to the center of right screen
• b "back" mouse button
• n "forward" mouse button
• f12,+ increase mouse move speed
• f11,_ decrease mouse move speed
• f10,) set mouse move speed to default
• !0 set mouse move speed to default
• !- set mouse move speed to slow
• != set mouse move speed to fast
• = volume up
• - volume down
• 0 volume off
• ^hjkl press arrow direction key
• f fast mode(press the keys on the screen to move the mouse to the specified area)
• F fast mode extend mode(extend fast mode, type twice to move to a more precise location)
• Capslock/i insert quick mode

Fast mode

This mode show a alpha table in the screen when opening, you can type the corresponding key to move the mouse to the specified area, so you can move mouse quickly to the specific district you want in the screen, you can also type Esc, ., Enter to cancel it.

There are two modes, the first Express mode, which is activated by pressing the f key in Normal mode, and the second Extended mode, which is activated by pressing the F key in Normal mode. Extended mode adds a level of tab tables to the quick mode to move more precisely to specified locations on the screen

It's a exactly cool way to move mouse, just enjoy it!

Normal Ext dragging mode

This mode is used for some 3D modeling software just like fusion360, it is disabled by default, you need to enable it manally

• +c hold down shft+middle click (hit +c or any mouse button again to release)
• ^c hold down ctrl+middle click (hit ^c or any mouse button again to release)

Normal "WASD" mode

You can also use the WASD keys if they're more natural to you than vim movement keys. Switch into and out of WASD mode with Win Alt v

WASD mode is now the default for Normal mode.

• wasd move the mouse
• WASD jump to edges of the screen
• z jump to center the screen
• q left click
• e right click
• r middle click
• 1 scroll down
• 2 scroll up
• ! scroll down more
• @ scroll up more
• 3 Home
• 4 End

Note that this necessarily unbinds d e and y from their Vim bindings. The rest of the hotkeys remain unchanged.

Explorer mode

• !jk press down/up arrow key
• !h move to the upper dir
• !l enter the item
• !p prev dir
• !b next dir
• ^o pop up the quick menu from the item

Chrome vim mode

This is automaticlly enabled in web browsers with chrome core, it is based on normal vim mode, especially it can pass through some keys to the browser to enable smoother operation with some extensions like surfingkeys or vimium, which can bring better web surfing experience with keyboard using vim key bindings. Switch into and out of chrome vim mode with Win Alt c

• f send f then enter QI (only in chrome vim mode for Vimium hotlinks)
• ^t send ctrl t then enter QI (new tab in the browser)
• x close current tab
• !x close current tab
• E prev tab
• R next tab

Insert mode

Acts like a normal keyboard.

Insert "Numpad" mode

You can also use the alt+alpha keys to input number instead of the number pad. Switch into and out of numpad mode with Win Alt p

• !u Numpad7
• !i Numpad8
• !o Numpad9
• !j Numpad4
• !k Numpad5
• !l Numpad6
• !m Numpad1
• !, Numpad2
• !. Numpad3
• !n Numpad0
• !` switch Small Mode

Insert "Numpad" small mode

This mode is for the keyboard with 65/60 layout which is small and has no F1-F12 keys.

• !u Numpad7
• !i Numpad8
• !o Numpad9
• !j Numpad4
• !k Numpad5
• !l Numpad6
• !m Numpad1
• !, Numpad2
• !. Numpad3
• !n Numpad0
• !Backspace Backspace
• !; +
• !' -
• ![ *
• !] /
• !Enter Enter
• >!1 f1
• >!2 f2
• >!3 f3
• >!4 f4
• >!5 f5
• >!6 f6
• >!7 f7
• >!8 f8
• >!9 f9
• >!0 f10
• >!- f11
• >!= f12
• ` Esc
• ^
• +` ~
• `! switch Small Mode

Win Alt n put you in Normal mode.

Normal "Quick" mode

If you're in persistent Insert mode and just need the mouse keys for a second, you can hold down Capslock to enter Normal "Quick" mode, which has all the same hotkeys as Normal mode and ends when Capslock is released.

Insert "Quick" mode

To quickly edit some text then return to Normal mode, a "quick" mode is also available for Insert. Great for typing into an address bar or a form field. Capslock toggles between Normal and quick Insert mode. Another good way to toggle quick Inser mode is: you can press i when cursor is "I" to enter quick Insert mode, and press ESC to return back to Normal mode, it is more convenient when you need input a little text in the UI.

Entering

From Normal mode

• Capslock toggle between QI and Normal mode
• i enter QI when cursor is "I"
• ^f send ctrl f then enter QI (commonly "search")
• Delete send Delete then enter QI (for quick fixes)

Only in Chrome vim mode

• f send f then enter QI (only in chrome vim mode for Vimium hotlinks)
• ^t send ctrl t then enter QI (new tab in the browser)

Exiting

From quick Insert mode:

• ESC exit to Normal mode
• Enter send Enter then exit to Normal mode
• Capslock toggle between Quick Insert and Normal mode

Last Remarks

Alternative to Numpad Mouse

I am aware of the Numpad Mouse feature included in Windows, and consider this a Massive improvement over the builtin functionality. I'll say that again, for search optimization, This is an alternative to Numpad Mouse with considerably better usability, and additional functionality. It is a faster and more convenient alternative to Numpad Mouse.

For Vim Purists

"Why doesn't i take me into Insert mode and Escape put me in Normal mode! >:U"

I made i left click. You've got Win Alt i which is a nice and unintrusive variant of i. We didn't even used to have that when Win Alt was part of Quick modes so there you go.

Escape is too useful a key to bind to anything. It was infuriating to hit Escape and not have the expected effect so I took it out.

~ Sorry, nerds :^)

"How come I can't make my own keybindings >:I"

I like these ones. You can fork the repo to make your own, or make a pull request if you want to set up managing an ini file :^)

The mouse moves too fast! (or too slow)

At the top of the file, mouse speed is controlled by two global variables, FORCE and RESISTANCE. FORCE controls acceleration and RESISTANCE causes diminishing returns and implicitly creates a terminal velocity.

Use the uncompiled .ahk script and you can change these to taste.

Contact

Bug reports, questions, feature requests, and pull requests are all welcome. Just open an issue on Github. (Or email me ! Don't be shy I'm really nice)