Recording Clear Bug Reproduction & Demo Videos with Keycastr (macOS)

Recording Clear Bug Reproduction & Demo Videos with Keycastr (macOS)

Public
Public
Tags
Developer Tools
macOS
Open Source
Author
Series
Productivity
Status
Done
Medium
dev.to
As a developer, my job isn’t just about writing code. I also spend a lot of time testing features and reviewing interns’ pull requests. Since our interns work remotely, it can be hard to clearly explain how to reproduce a bug using only text or meetings.
That’s when screen recordings become very helpful, especially when the video shows:
  • Which keys are pressed
  • Where the mouse clicks
  • The exact steps that cause the issue
We also record demo videos for clients to explain technical issues or new features. For these use cases, I found a simple and effective tool: Keycastr.

What’s Keycastr?

Keycastr is a lightweight, open-source macOS app that displays:
  • Keyboard inputs on screen
  • Mouse click events
It’s great for:
  • Bug reproduction videos
  • Feature demos
  • Code walkthroughs
  • Client support tutorials
It’s easy to use and doesn’t get in the way while recording.

How to install Keycastr

  • Run the command below to install the app
    • brew install --cask keycastr
  • Launch Keycastr from the Applications folder or Launchpad
  • Grant the relevant permission on Mac
  • Restart the app so the permissions take effect
  • Go to Display tab and customize the settings to your preference

My Recommended Settings

Here are the settings I use for clean and readable recordings:
notion image
  • Selected Visualizer: Set to “Svelte”
  • Display Mouse Events: Set to “Mouse Pointer”
 
 

Final Thoughts

If you often:
  • Work with remote teammates
  • Review pull requests
  • Record technical demos or tutorials
Keycastr is a great tool to have. It’s simple, reliable, and gets the job done.
Personally, this tool is really useful for me to record demo videos & bug reporting video.
Hope this sharing helps!

Reference

YouTubeYouTubeDisplay Keystrokes on MacBook Screen During Screen Recording