https://github.com/jordansissel/keynav

retire your mouse.
https://github.com/jordansissel/keynav

Last synced: 10 days ago
JSON representation

retire your mouse.

• Host: GitHub
• URL: https://github.com/jordansissel/keynav
• Owner: jordansissel
• License: other
• Created: 2011-02-16T03:03:22.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-04-18T13:31:41.000Z (7 months ago)
• Last Synced: 2024-10-14T19:19:05.031Z (28 days ago)
• Language: C
• Homepage:
• Size: 235 KB
• Stars: 589
• Watchers: 19
• Forks: 96
• Open Issues: 53
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELIST

Awesome Lists containing this project

• fucking-Awesome-Linux-Software - ![Open-Source Software - Keynav is a piece of an on-going experiment to make pointer-driven interfaces easier and faster for users to operate. It lets you move the pointer quickly to most points on the screen with only a few keystrokes. (Applications / Utilities)
• Awesome-Linux-Software - ![Open-Source Software - Keynav is a piece of an on-going experiment to make pointer-driven interfaces easier and faster for users to operate. It lets you move the pointer quickly to most points on the screen with only a few keystrokes. (Applications / Utilities)

README

        
keynav

======

Control the mouse with the keyboard.

Please see http://www.semicomplete.com/projects/keynav

Related Projects

----------------

This project (keynav) only works on X11, but if you want to use a similar tool for Windows, check out [keynavish](https://github.com/lesderid/keynavish)!

Compiling

---------

You may need some extra libraries to compile keynav.  On Debian and Ubuntu you can install these packages:

    sudo apt-get install libcairo2-dev libxinerama-dev libxdo-dev

Next you simply run make:

    make

This will produce an executable `./keynav` which may be run directly (or copied

somewhere in your path). You can also install (by default directly to `/usr`)

via `make install`.

On FreeBSD (and, I expect, other non-GNU platforms), you will want to use gmake.

FAQ

---

Q: What platforms are supported?  

A: keynav should work on nearly any Unix-like that runs X11. It has been

confirmed to work on extremely varied GNU/Linux systems (incuding RPM-based,

Debian derivatives, musl-based systems, and Arch), and FreeBSD. If you get it to

run elsewhere, please let me know so I can add it to the list. If you try to run

it on another Unix-like and have trouble, please get in touch and I'll try to

help. If attempting to run elsewhere, note that we currently have a dependency

on GNU Make (gmake), and it hasn't been tested with many compilers yet.

Q: Does it work on Android/Windows/Wayland/iOS/...?  

A: Sadly, no; keynav is totally dependent on X11, and porting it to any other

graphical system would really be a clone/rewrite. Although I am aware of no

exact analogues on other systems, I suggest looking into Tasker (Android),

AutoHotKey (Windows), and AppleScript (macOS). If you find something that works,

let me know and I'll consider adding it to this list.

Q: Can I use keynav to scroll?  

A: Yes! X11 represents mouse scrolling as key presses, so you just add the

relevant stanza to your keynavrc.  Mouse buttons are

1=left, 2=middle, 3=right, 4=scroll-up, 5=scroll-down, 6=scroll-left, 7=scroll-right. So for example to scroll up with i and down with e:

```

i click 4,end

e click 5,end

```

or to keep scrolling without having to re-invoke keynav, remove the end command from the bindings, like this:

```

i click 4

```