PressViz

A native macOS app for visualizing keyboard presses.

Installation

1. Download the latest DMG from Releases
2. Open the DMG file
3. Drag PressViz to your Applications folder
4. Launch PressViz from Applications

Security Note

PressViz is not notarized by Apple. On first launch, macOS may block the app.

To allow it, run this command in Terminal:

xattr -cr /Applications/PressViz.app

Requirements

• macOS 26.2+

Permissions

PressViz requires Accessibility permission to monitor keyboard input.

On first launch, macOS will prompt you to grant permission. If you dismissed the prompt:

• Click the PressViz icon in the menu bar to open the permission guide, or
• Enable manually: System Settings > Privacy & Security > Accessibility

Development

Prerequisites

• Xcode
• mise (optional, for task runner)
• create-dmg (for DMG creation)

Build

# Debug build
mise run build

# Release build
mise run release

# Clean
mise run clean

Version Management

# Show current version
mise run version

# Set version
mise run version:set 0.2.0

Create DMG

mise run dmg

License

MIT