TouchView

Wayland overlays for visualizing touchpad/touchscreen gestures and keyboard shortcuts. Shows semi-transparent panels using Layer Shell's OVERLAY layer — sits above all windows and panels, fully click-through.

Useful for demos, screen recordings, and showcasing compositor features.

Example (driftwm window movement):

https://github.com/user-attachments/assets/363d7252-dc28-4cf0-9c30-b7ca2e617972

Tools

• touchview — finger position overlay: a touchpad (white dots on a dark panel) or a touchscreen (--source touchscreen — circles at the real screen position, fullscreen, like Android's "show touches")
• keyview — keyboard shortcut overlay (shows key combos like "Super + L", "Alt + Tab")

Requirements

• Wayland compositor with layer shell support (sway, Hyprland, etc.)
• gtk4-layer-shell (system package)
• Access to /dev/input/event* (user must be in input group)

Install

pip install touchview

Or with uv:

uv tool install touchview

From source:

git clone https://github.com/malbiruk/touchview.git
cd touchview
pip install .

touchview

Visualizes finger positions in real-time. Two modes:

• touchpad (default) — dots on a dark panel anchored to a screen corner.
• touchscreen (--source touchscreen) — circles drawn at the real finger position on a fullscreen click-through overlay, like Android's "show touches". Ideal for screen-recording touchscreen demos.

touchview [OPTIONS]

Touchscreen mode is fullscreen with no backdrop, so --bg-*, --height, --radius, --position, and --margin apply to touchpad (panel) mode only.

# Touchpad: blue-tinted panel, bottom-left
touchview --bg-color '#1a1a2e' --position bottom-left

# Touchscreen: circles at your fingertips, fullscreen — for screen recordings
touchview --source touchscreen

# Rotated tablet — bump --rotate until the circles track your finger
touchview --source touchscreen --rotate 270

keyview

Shows keyboard shortcuts and key combos as an overlay.

• Modifier combos (Ctrl, Alt, Super, Shift + key) display as "Super + L"
• Lone modifier taps show the modifier name
• Auto-fades after timeout

keyview [OPTIONS]

# Both tools side by side — touchview right, keyview left
touchview --position bottom-right &
keyview --position bottom-left &

Positions

Both tools support: top-left, top, top-right, left, right, bottom-left, bottom, bottom-right

Permissions

sudo usermod -aG input $USER
# then log out and back in