---
name: "key-mon"
section: "1"
platform: "linux"
package: "key-mon"
version: "1.17-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/key-mon"
---

# key-mon(1)

Keyboard and mouse monitor window for GTK.

## NAME

Keymon - Keyboard and mouse monitor window for GTK.

## SYNOPSIS

**key-mon \[options\]**

## OPTIONS

- **-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.

- **--nometa**

  Opposite of **--meta**

- **--mouse**

  Show the mouse.

- **--nomouse**

  Opposite of **--mouse**

- **--shift**

  Show shift key.

- **--noshift**

  Opposite of **--shift**

- **--ctrl**

  Show the ctrl key.

- **--noctrl**

  Opposite of **--ctrl**

- **--alt**

  Show the alt key.

- **--noalt**

  Opposite of **--alt**

- **--scale**=*SCALE*

  Scale the dialog. ex. 2.0 is 2 times larger, 0.5 is half the size. Defaults to 1.0

- **--key-timeout**=*KEY\_TIMEOUT*

  Timeout before key returns to unpressed image. Defaults to 0.5

- **--mouse-timeout**=*MOUSE\_TIMEOUT*

  Timeout before mouse returns to unpressed image. Defaults to 0.2

- **--visible-click-timeout**=*VISIBLE\_CLICK\_TIMEOUT*

  Timeout before highly visible click disappears. Defaults to 0.2

- **--decorated**

  Show decoration

- **--nodecorated**

  Opposite of **--decorated**

- **--backgroundless**

  Show only buttons

- **--nobackgroundless**

  Opposite of **--backgroundless**

- **--no-press-fadeout**=*NO\_PRESS\_FADEOUT*

  Fadeout the window after a period with no key press. Defaults to 0.0 seconds (Experimental)

- **--only\_combo**

  Show only key combos (ex. Control-A)

- **--noonly\_combo**

  Opposite of **--only\_combo**

- **--sticky**

  Sticky mode

- **--nosticky**

  Opposite of **--sticky**

- **--visible\_click**

  Show where you clicked

- **--novisible\_click**

  Opposite of **--visible\_click**

- **--follow\_mouse**

  Show the mouse more visibly

- **--nofollow\_mouse**

  Opposite of **--follow\_mouse**

- **--kbdfile**=*KBD\_FILE*

  Use this kbd filename.

- **--swap**

  Swap the mouse buttons.

- **--noswap**

  Opposite of **--swap**

- **--emulate-middle**

  When you press the left, and right mouse buttons at the same time, it displays as a middle mouse button click.

- **--noemulate-middle**

  Opposite of **--emulate-middle**

- **-v**, **--version**

  Show version information and exit.

- **-t** THEME, **--theme**=*THEME*

  The theme to use when drawing status images (ex. "-t apple").

- **--list-themes**

  List available themes

- **--old-keys**=*OLD\_KEYS*

  How many historical keypresses to show (defaults to 0)

- **--reset**

  Reset all options to their defaults.

- **--opacity**=*OPACITY*

  Opacity of window

- **--loglevel**=*LOGLEVEL*

  Logging level

- **-d**, **--debug**

  Output debugging information. Shorthand for **--loglevel**=*debug*

- **--screenshot**=*SCREENSHOT*

  Create a "screenshot.png" and exit. Pass a comma separated list of keys to simulate(ex. "KEY\_A,KEY\_LEFTCTRL").

## DESCRIPTON

**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/.

## AUTHOR

Written by Scott Kirkwood (scott+keymon@forusers.com)

## SEE ALSO

Full documentation for **keymon** is available at

-

  **http://code.google.com/p/key-mon**

Send bugs to

-

  **http://code.google.com/p/key-mon/issues/list**