LinuxCommandLibrary

screenkey

Display pressed keys on screen for screencasts

TLDR

Display key presses on screen

$ screenkey
copy
Display keys and mouse buttons
$ screenkey -M
copy
Open settings menu
$ screenkey --show-settings
copy
Set display position
$ screenkey -p bottom
copy
Set modifier display format
$ screenkey --mods-mode emacs
copy
Customize appearance
$ screenkey --bg-color "#000000" -f "Monospace" --font-color yellow --opacity 0.8
copy
Display in fixed position with geometry
$ screenkey -p fixed -g 400x100+100+100
copy

SYNOPSIS

screenkey [options]

DESCRIPTION

screenkey is a screencast tool that displays pressed keys as an overlay on screen, making keyboard input visible to viewers during screencasts, tutorials, and live demonstrations. It captures all keystrokes system-wide and renders them in a customizable floating window.
The display supports multiple modifier key formats (Emacs, Mac, Windows style), configurable positioning, custom fonts and colors, and adjustable opacity. Mouse button clicks can also be shown alongside keyboard input. The overlay window can be placed at fixed screen positions or use custom geometry.
A settings GUI is available via --show-settings for interactive configuration. The tool integrates with X11 and runs as a background process, showing keys as they are pressed and fading them after a configurable timeout.

PARAMETERS

-M, --mouse

Display mouse button clicks
--show-settings
Launch the settings menu
-p, --position POSITION
Set display position (top, center, bottom, fixed)
-g, --geometry GEOMETRY
Set window geometry (for fixed position)
--mods-mode MODE
Set modifier key display format (normal, emacs, mac, win, tux)
--bg-color COLOR
Set background color (hex format)
-f, --font FONT
Set display font
--font-color COLOR
Set font color
--opacity VALUE
Set window opacity (0.0 to 1.0)
-t, --timeout SECONDS
Time to display each key
--key-mode MODE
Set key display mode (composed, translated, raw, keysyms)
--no-systray
Do not show system tray icon
-d, --debug
Enable debug output

CAVEATS

Requires X11; may not work properly on Wayland without XWayland. The tool captures all keystrokes system-wide, which may have security implications. Can be used with slop for custom window geometry selection.

HISTORY

screenkey was created for screencasting and educational purposes, allowing presenters to show keyboard input visually to their audience.

SEE ALSO

slop(1), xdotool(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community