screenkey
Display pressed keys on screen for screencasts
TLDR
Display key presses on screen
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.
