https://github.com/randoragon/mousemode
An intuitive, home-row mouse replacement.
https://github.com/randoragon/mousemode
keyboard linux mouse-emulation xorg
Last synced: about 2 months ago
JSON representation
An intuitive, home-row mouse replacement.
- Host: GitHub
- URL: https://github.com/randoragon/mousemode
- Owner: Randoragon
- License: mit
- Created: 2020-09-18T21:51:34.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-04-16T13:02:28.000Z (about 5 years ago)
- Last Synced: 2023-06-17T12:19:31.832Z (about 3 years ago)
- Topics: keyboard, linux, mouse-emulation, xorg
- Language: C
- Homepage:
- Size: 11.2 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.MD
- License: LICENSE
Awesome Lists containing this project
README
# mousemode
## Description
A dead-simple, reliable keyboard interface for moving the mouse cursor and pressing buttons. When the program
is executed, mousemode will:
1. allow you to use vim or arrow keys to move the mouse cursor
2. holding "c" will greatly decrease cursor speed
3. holding "f" will double the speed (can be combined with "c")
4. [a,s,d] keys correspond to left, middle and right mouse buttons
5. [e, y] keys correspond to scroll wheel down and up
6. "q" exits the program
During execution, all unmapped keys should behave as though mousemode is not running,
including adding modifiers to the mapped keys.
mousemode is aimed at laptop power users that are annoyed with touchpads or people that in general find themselves
in a position uncomfortable to be using the mouse via conventional means. The "f" and "c" keybindings feel a bit
strange at first, but I wanted to avoid standard modifiers like shift and control, because some programs have
shortcuts with those (for example vim, if you enable the mouse feature, selects differently when you hold shift).
Many similar programs to mousemode will lock the entire keyboard when active. mousemode only locks what is absolutely
necessary, because it is targeted at people with keyboard-driven workflows, who often use global keyboard shortcuts
to switch around windows, workspaces, etc. Once you memorize all the keys, you're in charge.
---
mousemode does NOT use Xlib events. In fact, by nature it does not distinguish between key presses and releases.
Instead, it reads the keyboard state 60 times a second and emulates mouse clicks/movement accordingly. This
synchronous nature allows it to be very simple and reliable (only about 120 lines of code).
## Installation
For arch users, you can install the [AUR package](https://aur.archlinux.org/packages/mousemode-git/) `mousemode-git`.
If you're not an arch user, the building process is very straight forward.
## Building
You should only need Xlib, which is widely available on virtually all linux distributions. You very likely
already have it installed!
Run the following (if necessary, as root):
make install
The resulting binary will be installed at `/usr/local/bin/mousemode`.