Bug report videos your team can watch in thirty seconds.
A short recording beats ten paragraphs of repro steps. Dolly shows your keystrokes, zooms on the click that breaks, blurs your tokens and puts the video on your clipboard.
How do you record a bug report video on a Mac?
Start from a clean state, press ⇧⌘2 in Dolly and reproduce the bug, saying what you expected out loud. Turn on the keystroke overlay so shortcuts show, and let Private details blur API keys and emails. Keep it under two minutes, then use the GitHub preset for an MP4 under 10 MB, or copy the video and paste it into Jira, Linear or Slack.
Who it’s for: Developers, QA engineers, designers and support staff filing or triaging bugs.
Show the steps, not a paragraph.
Record the repro once. Your keystrokes are on screen.
How to record a bug report video in Dolly.
4 steps, most of them automatic.
- Start cleanReload, open the console or network tab, and say what you expect to happen.
- Record the repro⇧⌘2, do the steps, hit the bug, stop. Keystroke overlay on. Press ⇧⌘D to circle the broken bit while you record.
- Blur secretsPrivate details finds API keys, tokens and emails on screen; accept the blurs in one click.
- Paste it in the issuePick the GitHub preset for a file under 10 MB, or copy to the clipboard and paste into Jira, Linear or Slack.
Settings that work, and what to avoid.
Recommended settings
- Shape
- Auto (keeps your window's shape)
- Resolution
- 1080p
- Frame rate
- 30 fps
- Quality
- Web, to stay under upload limits
- Length
- Under 2 minutes
Mistakes to avoid
- Starting mid-bug. Show the starting state first.
- Hiding the console. The error message is often the most useful frame.
- Tokens on screen. Run Private details before you share.
- Five minutes for a one-click bug. Cut the setup and the waiting.
Video or written repro steps?
Written steps are searchable; video shows what words miss: timing, hover states, the exact click. Best is both: three lines of text and a 30-second video. macOS ⇧⌘5 records too, but it doesn't show keystrokes, blur secrets or size the file for GitHub. The bug report video guide has a checklist.
Dev updates and AI recordings
The same setup works for weekly demos to your team: record what shipped, cut the waiting, paste it in the channel. With Dolly Pro, Claude Code can record your terminal while it runs the tests and cut the waiting for you; see Dolly Agents.
Bug reports and dev updates: questions
How do I record a bug report video on a Mac?
Record the steps with your keystrokes visible, blur any secrets, keep it under two minutes, and attach the MP4 or GIF to the issue. Dolly's GitHub preset keeps the file under 10 MB.
What's GitHub's file size limit for videos and GIFs?
GitHub limits images and GIFs to 10 MB; video limits depend on your plan. Dolly's GitHub preset picks resolution and bitrate so the file lands under 10 MB.
Can I paste a Dolly recording into GitHub, Jira or Linear?
Yes. Copy the video from Dolly and paste it into the issue, or drag the exported MP4 or GIF in.
How do I hide API keys in a screen recording?
Run Private details in Dolly. It finds API keys, tokens, emails and card numbers on screen and blurs them, following text as it scrolls.
Can I show my keystrokes in a screen recording?
Yes. Turn on Dolly's keystroke overlay; it needs Input Monitoring permission in System Settings.
Related
Roll camera.
Screen Studio quality. Free. No 5-minute limit.
First time: open Dolly, click Done, then System Settings → Privacy & Security → Open Anyway (macOS 13–14: right-click Dolly → Open). Once only. Installation help