Kiwi

A key visualizer for COSMIC DE. Shows an overlay of your keystrokes, mouse clicks, and gestures.

Features

• Real-time keystroke visualization overlay
• Mouse button and scroll wheel display
• Touchpad gesture recognition (swipes, holds)
• System tray integration
• Configurable position, size, colors, and ...
• Multiple color palettes

Requirements

• COSMIC DE
• Rust
• just
• User must be in the input group (for libinput access)

Build

just build-release

Install

sudo just install

This installs to /usr/bin/kiwi along with desktop entry and icons.

Uninstall

sudo just uninstall

Setup

Add yourself to the input group

Kiwi uses libinput to capture keystrokes, which requires read access to /dev/input/* devices:

sudo usermod -aG input $USER

Log out and log back in for the group change to take effect.

Verify group membership

groups | grep input

Usage

Launch Kiwi from your application menu or run:

kiwi

Kiwi runs as a tray icon. Click the tray icon to toggle the overlay. Right-click for settings and quit options.

Configuration

Settings are stored via cosmic-config and can be accessed through the tray icon menu.

Security

Adding yourself to the input group grants read access to all input devices (/dev/input/*). This means any program you run can read all keystrokes, including passwords. Only do this on systems you trust and where you control what software runs.

Why Kiwi?

It's a Key Visualizer!