Scroll to navigation

KEYMON(1) User Commands KEYMON(1)


Keymon - Keyboard and mouse monitor window for GTK.


key-mon [options]


show this help message and exit
Make the dialog 25% smaller than normal.
Make the dialog 25% larger than normal.
Show the meta (windows) key.
Opposite of --meta
Show the mouse.
Opposite of --mouse
Show shift key.
Opposite of --shift
Show the ctrl key.
Opposite of --ctrl
Show the alt key.
Opposite of --alt
Scale the dialog. ex. 2.0 is 2 times larger, 0.5 is half the size. Defaults to 1.0
Timeout before key returns to unpressed image. Defaults to 0.5
Timeout before mouse returns to unpressed image. Defaults to 0.2
Timeout before highly visible click disappears. Defaults to 0.2
Show decoration
Opposite of --decorated
Show only buttons
Opposite of --backgroundless
Fadeout the window after a period with no key press. Defaults to 0.0 seconds (Experimental)
Show only key combos (ex. Control-A)
Opposite of --only_combo
Sticky mode
Opposite of --sticky
Show where you clicked
Opposite of --visible_click
Show the mouse more visibly
Opposite of --follow_mouse
Use this kbd filename.
Swap the mouse buttons.
Opposite of --swap
When you press the left, and right mouse buttons at the same time, it displays as a middle mouse button click.
Opposite of --emulate-middle
Show version information and exit.
The theme to use when drawing status images (ex. "-t apple").
List available themes
How many historical keypresses to show (defaults to 0)
Reset all options to their defaults.
Opacity of window
Logging level
Output debugging information. Shorthand for --loglevel=debug
Create a "screenshot.png" and exit. Pass a comma separated list of keys to simulate(ex. "KEY_A,KEY_LEFTCTRL").


Keymon is a program to help in teaching or podcasting by showing the current status of the mouse buttons and keyboard.

Keymon creates a small, borderless window which always stays topmost and monitors the keystrokes and mouse buttons used at any time in any program.

Configuration files are saved in ~/.config/key-mon/.


Written by Scott Kirkwood (


Full documentation for keymon is available at

Send bugs to
January 2014 Keymon version 1.17.