Skip to content

mickeykorea/keypress

Repository files navigation

Keypress

GitHub release License Platform

Keypress icon (light)    Keypress icon (dark)

A keystroke visualizer for macOS. Shows what you're typing as a floating overlay on screen. Built for screen recordings, live demos, and tutorials, where viewers need to see what keys are being pressed.


Features

  • Real-time keystroke overlay styled after the Apple Magic Keyboard
  • Modifier symbols ⌘ ⌥ ⇧ ⌃ with proper Apple iconography
  • Light / Dark / Auto / Custom themes follows your system appearance or let you pick your own colors
  • Stack & Single display modes to show keystroke history or just the latest key
  • 6 preset positions + drag-to-reposition so you can place the overlay wherever you want
  • Multi-monitor support choose which display to show the overlay on
  • Adjustable size, opacity, and duration to tweak it until it feels right
  • Global toggle ⌥⌘K to show/hide from any app
  • Intuitive settings UI with only the essentials, no BS

Installation

You can download the latest version of Keypress from the Release page.

  • macOS: Download the .dmg. Keypress requires Accessibility permission to capture keystrokes. On first launch, grant access in: System Settings > Privacy & Security > Accessibility

Contribution

If you want to contribute or build from source, make sure you have Node.js installed.

  1. Clone the repository:

    git clone https://github.com/mickeykorea/keypress.git
    cd keypress
  2. Install dependencies:

    npm install
  3. Build the .dmg:

    npm run build

Feedback


License

GPL-3.0

Keypress is free and open source. Displaying keystrokes isn't high technology, nor should it cost you any money.

About

Visualize keystrokes on screen. No subscriptions, no bloat, no nonsense. Open source that gets the job done.

Topics

Resources

License

Stars

Watchers

Forks

Contributors