# How to Show Keystrokes on Screen on Mac

> macOS has no keystroke overlay. Here is what the built-in tools do, and how to show every shortcut as a keycap.

- Canonical URL: https://getedith.pro/guides/show-keystrokes-on-screen-mac
- Published: 2026-11-15
- Updated: 2026-11-15

## The short answer

macOS cannot draw the keys you press as an overlay. The closest built-in tool is Keyboard Viewer, an on-screen keyboard you can leave open while you record, and the screen recording toolbar can show mouse clicks but not keys. To show each shortcut as a keycap your viewers can read, turn on Edith's [show keystrokes on screen](https://getedith.pro/extensions/show-keystrokes) extension, Keystroke Highlight, with ⌃⌥⌘K.

## Method 1: Keyboard Viewer

Built into macOS

### Show the on-screen keyboard

1. Open System Settings, then Keyboard. Under Text Input, click Edit next to Input Sources and turn on Show Input menu in menu bar.
2. Click the Input menu in the menu bar and choose Show Keyboard Viewer.
3. Move the floating keyboard to a corner of the screen you record.

Holding Option or Shift changes the characters it shows, which helps when you explain a key combination. Apple covers the setup in [Use the Keyboard Viewer on Mac](https://support.apple.com/guide/mac-help/use-the-keyboard-viewer-on-mac-mchlp1015/mac).

## Method 2: show mouse clicks in a recording

Built into macOS

### Screenshot toolbar options

Press ⇧⌘5, choose Record Entire Screen or Record Selected Portion, open Options and turn on Show Mouse Clicks. Clicks appear as a circle in the recording. The same Options menu picks a microphone and a save location.

## Where the built-in tools fall short

- **Keyboard Viewer is a keyboard, not a caption.** It shows the whole layout, so viewers still have to work out which keys you pressed, and it covers a large part of the screen.
- **No trail.** Nothing shows which shortcut you just used, so a quick ⇧⌘P is over before anyone reads it.
- **Clicks only.** Show Mouse Clicks does not show the keyboard at all.

## The Edith way: Keystroke Highlight

Keystroke Highlight draws each key press and shortcut as a keycap at the edge of the screen, then fades it out. It shows keys only while it is turned on, never shows what you type into secure password fields, and uses key presses only to draw the keycaps. They are never saved.

1. 1
   ### Install Keystroke Highlight
   It is one of Edith's extensions, so it installs from the Extensions page or with a single command.
   `ed extensions install keystrokeHighlight`
2. 2
   ### Allow Input Monitoring
   macOS asks once. Edith needs Input Monitoring to see key presses so it can draw them.
3. 3
   ### Turn it on from any app
   Press the shortcut to start the overlay, and press it again to pause. Pausing before you type something private takes one keystroke.
   ⌃⌥⌘K
4. 4
   ### Place and time the keycaps
   In settings, choose the edge of the screen where keycaps appear and how long each key stays before it fades. A longer duration suits tutorials; a shorter one suits fast live demos.

## Record it with the rest of the demo kit

Keycaps matter most in a recording. Edith's [screen recorder for Mac](https://getedith.pro/extensions/screen-recorder) records a display or chosen windows, with system audio, a microphone and the cursor if you want them, captures at 1080p, 4K or source resolution up to 8K, and exports HEVC or ProRes 422 files. It needs macOS 15 or later. It can also capture a frame every few seconds and turn a long session into a short time-lapse.

Two more help the viewer follow along. [Focus Dim](https://getedith.pro/extensions/focus-dim) darkens every window except the one you are working in, toggled with ⌥⌘F. [Presenter mode](https://getedith.pro/extensions/presenter-mode) blurs private details inside Edith, such as cost figures, music, calendar events and agents, while you share or record. It can turn on by itself when it detects screen sharing, and ⌥⇧⌘P forces it on or off.

```
 ed presenter start
 ed presenter status
 ed presenter stop
```

Before you hit record

Turn on Keystroke Highlight and Presenter, then do a ten second test recording. Check that the keycaps do not sit on top of the part of the screen you are explaining, and move them to another edge if they do.

## Tips for keystrokes people can read

- **Slow down your shortcuts.** Press a shortcut, pause for a beat, then move on. The keycap needs a moment on screen before the next one replaces it.
- **Pause the overlay for long typing.** A sentence typed into a search field turns into a stream of single letters. Press ⌃⌥⌘K to pause before you type prose, and again before the next shortcut.
- **Say the shortcut out loud.** Viewers who listen rather than watch catch it too, and the keycap confirms what you said.
- **Keep the edge consistent.** Pick one position for the whole series of videos so returning viewers know where to look.

The full recording workflow, including a virtual camera and a mute shortcut, is in [record a product demo](https://getedith.pro/use-cases/record-a-product-demo).

## Common questions

### Does Keystroke Highlight record what I type?

No. It reads key presses only to draw the keycaps, does not save them, and never shows input from secure password fields.

### Can I change the shortcut?

Yes. Every Edith shortcut works from any app and can be re-recorded in settings.

### Does it work in screen shares as well as recordings?

Yes, when the whole screen is captured. The keycaps are drawn on screen in their own overlay, so a full-screen recording or a full-screen share shows them, while sharing a single app window does not.

## Edith extensions used

- [Show Keystrokes on Screen on Mac](https://getedith.pro/extensions/show-keystrokes): Show the keys you press on screen for demos and recordings.
- [Screen Recorder for Mac With Time-Lapse Mode](https://getedith.pro/extensions/screen-recorder): Record your screen, or speed up a long session into a short time-lapse.
- [Hide Private Info When Screen Sharing on Mac](https://getedith.pro/extensions/presenter-mode): Blur private details in Edith while you share your screen.
- [Dim Background Windows on Mac](https://getedith.pro/extensions/focus-dim): Dim everything except the window you are working in.

## Related guides

- [How to Run Multiple Claude Code Agents on Mac](https://getedith.pro/guides/run-multiple-claude-code-agents-mac): Run several Claude Code agents in parallel on a Mac with git worktrees and agent view, then watch every agent on one board and answer the blocked ones.
- [How to See Clipboard History on Mac](https://getedith.pro/guides/see-clipboard-history-mac): See clipboard history on a Mac with Spotlight in macOS Tahoe, the Finder clipboard and pbpaste, or a searchable history with pins one shortcut away.
