key-mon 1.13

Keyboard Status Monitor
  6 Screenshots
key-mon is useful for teaching or podcasts (video podcasts) to show the current keyboard status and which mouse buttons are pressed.


Download the zip file and unzip into a directory.

unzip key-mon*.zip
cd key-mon*
sudo python install

To run just type:


Note: The script may ask for your super user password at this point to get access to your USB events.

You can make the dialog --smaller or --larger.


key-mon --smaller

Here's the help:

key-mon --help

 -h, --help show this help message and exit
 -s, --smaller Make the dialog 25% smaller than normal.
 -l, --larger Make the dialog 25% larger than normal.
 -m, --meta Show the meta (windows) key.
 --nomouse Hide the mouse.
 --noshift Hide the shift key.
 --noctrl Hide the ctrl key.
 --noalt Hide the alt key.
 --scale=SCALE Scale the dialog. ex. 2.0 is 2 times larger, 0.5 is
 half the size.
 --kbdfile=KBD_FILE Use this kbd filename instead running xmodmap.
 --swap Swap the mouse buttons.
 --emulate-middle If you presse the left, and right mouse buttons at the
 same time, show it as a middle mouse button.
 -d, --debug Output debugging information.
 -t THEME, --theme=THEME
 The theme to use when drawing status images
 -v, --version Show version information and exit.
 Create a screenshot.png and quit.

Main features:

  • The window can be scaled to any size.
  • Different keyboard themes/styles supported, like the Mac look.
  • Starts without a window border.
  • Right click provides an application menu.
  • Supports the META (aka Windows) key.
  • Supports the scroll wheel.
  • Supports all three mouse buttons.
  • Should support multiple mouses or keyboards (untested).
  • Move the window by dragging from anywhere inside.
  • Swap the left and right mouse buttons.
  • Emulate middle click by clicking left and right mouse buttons.
  • When the dialog is smaller a different set of images are used for a better look.
  • Support for foreign keyboards.
  • Ability to make your own keyboard scancode maps, for when the defaults don't work.

last updated on:
July 2nd, 2012, 23:56 GMT
license type:
LGPL (GNU Lesser General Public License) 
developed by:
Scott Kirkwood
ROOT \ Education
Download Button

In a hurry? Add it to your Download Basket!

user rating 3



Rate it!
6 Screenshots
What's New in version 1.1
  • A little smarter about key names when the keycodes don't seem to match.
  • Fixed and improved the debian install.
  • Fixed Issue 25. Darken the mouse buttons.
read full changelog

Add your review!