KeyCastr
Open-source keystroke visualizer

KeyCastr — Official Website
Quick Take: KeyCastr
KeyCastr is the standard keystroke visualizer for macOS — free, simple, and effective. It solves a specific problem (making keyboard shortcuts visible to viewers) and solves it well. If you create screencasts, record tutorials, give conference presentations, or do pair programming over video calls, KeyCastr is worth installing. If you don't do any of those things, you don't need it. The customization options are thorough (appearance, position, filtering), and the overhead is minimal (menu bar app, no dock icon, low resource usage). It's the kind of utility that does its job so well you forget it's running.
Best For
- •Screencast creators and YouTube tutorial makers
- •Conference speakers and live demo presenters
- •Developers doing pair programming over video calls
- •Educators teaching keyboard-driven workflows (Vim, terminal, IDE shortcuts)
What is KeyCastr?
KeyCastr is a free, open-source keystroke visualizer for macOS. It shows your keyboard shortcuts on screen as you press them — a floating overlay that displays each key combination in real-time. When you press Cmd+Shift+P, the overlay shows '⌘⇧P' on your screen. The primary use case is screencasting. When you record a tutorial, your viewers can't see your keyboard. They watch your cursor move and things happen on screen, but they don't know what you pressed. KeyCastr solves this by displaying each keystroke as a visual overlay on your recording. A coding tutorial becomes more useful when viewers see 'Cmd+P' appear when you open the command palette, or 'Cmd+S' when you save. The second use case is live presentations. During a demo or conference talk, the audience watches your screen on a projector. They can follow along much better when they see which shortcuts you're using. This is especially true for presentations about tools, editors, or development workflows where keyboard shortcuts are the point. KeyCastr is highly customizable. Choose the position (any corner or center), font size, colors, opacity, fade duration, and whether to show individual keys or full modifier combinations. You can filter which keys are displayed — show only modifier combinations (Cmd+X, Ctrl+C) while hiding regular typing. This prevents the overlay from showing every letter you type in a text editor, which would be distracting and potentially reveal sensitive content. The app is lightweight: it runs in the menu bar, displays an overlay on key events, and uses minimal resources. There's no recording, no analytics, no network access. It reads keyboard events through macOS Accessibility APIs, which means you need to grant Accessibility permission in System Settings. KeyCastr is completely free and open-source (BSD license). There's no paid tier, no registration, no feature limits. It's maintained by a small community on GitHub and receives updates for macOS compatibility. The honest take: KeyCastr does one thing and does it well. If you make screencasts, record tutorials, or give live presentations where keyboard shortcuts matter, KeyCastr is exactly the tool you need. If you don't do those things, you'll never need it. It's a niche tool that's perfect for its niche.
Install with Homebrew
brew install --cask keycastrDeep Dive: Why Keystroke Visualization Matters for Developer Content
How showing keyboard shortcuts improves tutorials, presentations, and pair programming.
History & Background
KeyCastr was created to fill a gap in the macOS screencasting workflow. Screen recording captures video and audio, but keyboards are invisible. Presenters would say 'now I'll press Cmd+Shift+P' while the audience might miss it, or they'd need to add post-production callouts for every shortcut. KeyCastr makes shortcuts visible in real-time, eliminating post-production work and making live presentations more followable. The project has been maintained by the open-source community for over a decade, with updates focused on macOS compatibility.
How It Works
KeyCastr registers a global event listener using macOS's Accessibility framework (kAXTrustedCheckOptionPrompt). When a key event is detected, it renders the keystroke as a text overlay using NSWindow with a transparent background. The overlay fades out after the configured duration. The filtering logic checks whether modifier keys are pressed and optionally suppresses events without modifiers. The approach is lightweight — no polling, no continuous rendering, just event-driven display.
Ecosystem & Integrations
KeyCastr works alongside any recording or streaming software because it's a screen overlay, not a plugin. It pairs naturally with OBS (for streaming), ScreenFlow or Final Cut (for recording), Zoom/Google Meet (for presentations), and QuickTime (for simple recordings). No integration needed — whatever captures your screen captures KeyCastr's overlay.
Future Development
KeyCastr is mature and stable. Updates focus on macOS compatibility, minor UI improvements, and bug fixes. The core functionality — displaying keystrokes as a screen overlay — is feature-complete. Community contributions occasionally add new display styles or configuration options.
Key Features
Real-Time Keystroke Display
Every key combination you press appears on screen as a floating overlay. Press Cmd+S, and '⌘S' appears. Press Ctrl+Option+Delete, and '⌃⌥⌦' appears. The overlay fades after a configurable duration (default: 1-2 seconds). Multiple rapid keystrokes queue and display sequentially. This is the core feature — making invisible keyboard input visible to anyone watching your screen.
Customizable Appearance
Configure the font (size, family, weight), text color, background color, opacity, corner radius, and position on screen. Place the overlay in any corner, edge, or center of any monitor. Adjust the fade-out duration. Some people prefer a large, high-contrast overlay in the bottom-right corner; others prefer a subtle, small display in the top-left. KeyCastr adapts to your visual preference and screen layout.
Modifier-Only Filtering
Enable 'Display Command keys only' to show only keystrokes that include modifier keys (Cmd, Ctrl, Option, Shift). This prevents every letter you type from appearing on screen — useful when you're typing in a text editor or terminal and don't want the overlay showing every character. Only meaningful shortcuts (Cmd+S, Ctrl+C, Cmd+Shift+P) appear, keeping the display clean and informative.
Multi-Monitor Support
Choose which display shows the keystroke overlay. For presentations, you might want keystrokes on the projector display but not your primary monitor. For screencasts, you typically want keystrokes on the monitor being recorded. KeyCastr lets you select the target display.
Menu Bar Control
KeyCastr runs as a menu bar app. Click the icon to toggle the overlay on and off, access preferences, or quit. No dock icon clutter. Toggling on and off is useful: turn it on for recording segments where shortcuts matter, turn it off for segments where you're just typing or clicking.
Who Should Use KeyCastr?
1The YouTube Tutorial Creator
A developer records VS Code tutorials for YouTube. They enable KeyCastr before recording. When they demonstrate features — Cmd+P for file search, Cmd+Shift+F for project-wide search, Ctrl+` for terminal toggle — the shortcuts appear on screen. Viewers follow along on their own keyboards. The tutorial is more useful because viewers learn both what the feature does and how to access it.
2The Conference Speaker
A presenter demonstrates a terminal workflow at a tech conference. The audience watches on a projector. KeyCastr shows every shortcut as the presenter navigates tmux panes, Vim buffers, and shell commands. The audience learns the workflow and the shortcuts simultaneously. Without KeyCastr, they'd see magic happening on screen with no way to reproduce it.
3The Team Lead Doing Screen Shares
During pair programming sessions over Zoom, a senior developer uses KeyCastr so their pair partner can see shortcuts. When the senior developer uses Cmd+D to multi-select in VS Code or Ctrl+K to cut a line, the partner sees the shortcut and learns it. Over weeks of pairing, the junior developer absorbs dozens of editor shortcuts they wouldn't have discovered otherwise.
How to Install KeyCastr on Mac
KeyCastr installs via Homebrew or direct download from GitHub.
Install via Homebrew
Run: brew install --cask keycastr. This installs KeyCastr to your Applications folder.
Grant Accessibility Permission
On first launch, macOS will ask for Accessibility access. Go to System Settings > Privacy & Security > Accessibility and enable KeyCastr. This permission is required for KeyCastr to read keyboard events.
Configure and Start
Click the KeyCastr icon in the menu bar. Open Preferences to customize position, appearance, and filtering. Toggle the overlay on to start displaying keystrokes.
Pro Tips
- • Enable 'Display Command keys only' to prevent regular typing from showing in the overlay.
- • Position the overlay in the bottom-right corner for screencasts — it's visible but doesn't cover important UI elements.
- • Toggle KeyCastr off when typing passwords or sensitive information.
- • Increase font size for conference presentations where the audience is far from the screen.
Configuration Tips
Optimize for Screencasting
For screen recordings: position the overlay in the bottom-right corner. Use a dark background with white text (or vice versa, depending on your screen content). Set font size to 20-28pt. Enable 'Command keys only' to filter out regular typing. Set fade duration to 1.5-2 seconds. This configuration provides clear, non-distracting keystroke display in recorded content.
Optimize for Live Presentations
For conference talks: use a larger font (28-36pt) because the audience is viewing on a projector from a distance. Position the overlay centrally at the bottom. Use high contrast (white text on black background with 80% opacity). Disable fade or use a long fade (3+ seconds) so the audience has time to read the shortcut.
Pair with OBS for Streaming
If you stream coding sessions, KeyCastr's overlay appears in your OBS screen capture. Position it where it doesn't overlap with your chat overlay or facecam. Viewers see your keystrokes in the stream in real-time. This works without any OBS-specific setup — KeyCastr is just a screen overlay.
Toggle Before Sensitive Input
Remember to turn off KeyCastr before entering passwords, API keys, or any sensitive text. Even with 'Command keys only' enabled, some sensitive actions use keyboard shortcuts that you might not want visible. Get in the habit of toggling via the menu bar icon.
Alternatives to KeyCastr
KeyCastr is the standard keystroke visualizer for macOS. Alternatives offer different approaches or additional features.
Keystroke Pro
Keystroke Pro ($9.99) is a paid keystroke visualizer with a more polished UI, additional display styles (linear list, radial), and analytics (track your most-used shortcuts). It's more feature-rich than KeyCastr but costs money. If the free, minimal approach of KeyCastr works for you, there's no reason to pay. If you want analytics or better visual styling, Keystroke Pro is a reasonable upgrade.
ShowyEdge
ShowyEdge shows which input source (keyboard language) is active by coloring a stripe at the top of the screen. It doesn't show individual keystrokes. It's useful for multilingual users but solves a different problem than KeyCastr.
Screen Recording Software with Built-In Keystroke Display
Some screen recording tools (like ScreenFlow) have built-in keystroke display. If you already use ScreenFlow for recording, its built-in feature might replace KeyCastr. But KeyCastr works with any recording tool, any streaming software, and live presentations — it's not tied to a specific recording app.
Pricing
KeyCastr is completely free and open-source, licensed under BSD. No paid tiers, no registration, no limits. Development is community-driven on GitHub.
Pros
- ✓Free and open-source (BSD license)
- ✓Simple, focused functionality — does one thing well
- ✓Highly customizable appearance (position, size, colors, opacity)
- ✓Modifier-only filtering prevents regular typing from showing
- ✓Works with any recording software, streaming tool, or live presentation
- ✓Lightweight — minimal resource usage, menu bar only
- ✓Multi-monitor support for choosing which display shows keystrokes
Cons
- ✗Niche tool — only useful for screencasting, presentations, and teaching
- ✗No keystroke analytics or usage tracking (Keystroke Pro has this)
- ✗Must manually toggle off before typing sensitive information
- ✗UI is basic — no fancy display styles beyond a text overlay
- ✗Requires Accessibility permission, which some managed Mac policies restrict
- ✗Occasional macOS update compatibility issues (usually fixed quickly)
Community & Ecosystem
KeyCastr is hosted on GitHub (keycastr/keycastr) and maintained by the open-source community. The project has been around for years and is well-established in the macOS screencasting ecosystem. Issues and pull requests on GitHub are addressed, though the pace is relaxed — it's a mature tool that doesn't need frequent updates. YouTube tutorials about screencasting often mention or demonstrate KeyCastr. It's a standard recommendation in 'how to make coding tutorials' guides.
Video Tutorials
Getting Started with KeyCastr
More Tutorials
Install and Display Keystrokes on macOS Screen for Free 2025 | KeyCastr – Open Source Keystroke Visu
FewSteps • 139 views
Install KeyCastr in Mac Mojave
Tijo Kuriakose • 1.2K views
Keycastr downloading and installing
A B Hetzel • 3.8K views
Frequently Asked Questions about KeyCastr
Our Verdict
KeyCastr is the standard keystroke visualizer for macOS — free, simple, and effective. It solves a specific problem (making keyboard shortcuts visible to viewers) and solves it well. If you create screencasts, record tutorials, give conference presentations, or do pair programming over video calls, KeyCastr is worth installing. If you don't do any of those things, you don't need it. The customization options are thorough (appearance, position, filtering), and the overhead is minimal (menu bar app, no dock icon, low resource usage). It's the kind of utility that does its job so well you forget it's running.
About the Author
Productivity & Workflow Analyst
Related Technologies & Concepts
Related Topics
Screencasting Tools for Mac
Tools for recording, presenting, and sharing screen content.
Developer Presentation Tools
Utilities that help developers demonstrate workflows and tools.
Sources & References
Fact-CheckedLast verified: May 6, 2026
Key Verified Facts
- KeyCastr is an open-source keystroke visualizer licensed under BSD.[fact1]
- 1KeyCastr GitHub Repository
Accessed May 6, 2026
Research queries: KeyCastr macOS 2026 keystroke visualizer review