Mouse Emulator

If your mouse is a potato or you just don’t have one, this project lets you emulate a mouse using your keyboard!

Requirements

• A keyboard (mechanical recommended)
• uinput kernel module (use modprobe uinput)

Key Mappings

• W/A/S/D: Move the mouse around.
• Q: Left-click.
• E: Right-click.
• R: Middle-click.
• PageUp: scroll up.
• PageDown: scroll down.
• Home: next page.
• End: previous page.
• Right Ctrl: Activate mouse emulation (the potato key!).
• Shift: Slow things down by 5x.

Building

make
make install

Notes

Changing Potato Key: To set the potato key to KEY_F23 (Copilot key), use the command:

make CFLAGS="-DKEY_POTATO=KEY_F23"

Enabling Toggle Mode: To activate toggle mode, run the following command:

make CFLAGS="-DTOGGLE=true"

Usage

First, list devices:

/usr/libexec/mouse-emu

Example output:

Searching:
/dev/input/event21 => 2.4G Composite Device
/dev/input/event3 => SEMICO USB Gaming Keyboard

Then, use your device:

/usr/libexec/mouse-emu /dev/input/event3