·
48 commits
to main
since this release
This release adds API key authentication for the Cap CLI, a safety check that stops you from accidentally recording without a microphone, and a batch of fixes covering memory leaks on macOS, recordings that failed to open, and lighter instant recordings.
It also fixes a rare error that could stop a recording partway through on macOS and Windows, makes pause and resume more robust, extends disk-space protection to every recording mode, and adds an optional MacBook notch overlay to Studio Mode.
Features
- API keys for the CLI - Generate API keys from your account settings on the Cap dashboard and set the
CAP_API_KEYenvironment variable to authenticate the Cap CLI without a browser login. This makes it possible to run Cap in CI, on remote servers, and with agents in headless environments. You can list and revoke your keys from the dashboard at any time. - Confirm before recording without a microphone - Cap now asks for confirmation before starting a recording when no microphone is selected or the selected microphone is unavailable, so you never finish a take only to find it silent. It is on by default and can be turned off in Settings under General.
- Exclude floating panels from recordings on macOS - The excluded-windows picker in Settings now lists floating accessory panels, like quick launchers and utility palettes, so you can keep them out of your recordings too.
- MacBook notch overlay in Studio Mode - Screen capture records straight through the physical notch, so recordings of a notched MacBook show an unbroken menu bar where you saw a cutout. Studio Mode can now draw the notch back over the recording, in both the editor preview and exports, and it follows your crop, padding, and zoom automatically. New recordings capture the exact notch geometry at record time; for older recordings you can position the overlay by hand.
Fixes
- Recordings with a damaged mic track open again - A recording whose microphone audio file was empty or unreadable previously refused to open in the editor at all. The editor now opens the recording without the mic audio and logs a warning instead, and exports still validate audio strictly so a track is never silently dropped from a final file.
- Memory growth while idle on macOS - Routine permission checks queried the display list every few seconds and leaked a small amount of memory each time, which could add up to significant usage over long sessions. This is fixed, along with smaller leaks in camera enumeration, display name and scale lookups, microphone device names, and the mic volume meter.
- Recording start feedback - Clicking record from the target picker now shows a loading state immediately instead of appearing to do nothing while the recording starts.
- Window screenshots on Windows - Taking a screenshot of a window no longer fails because the picker window closed itself before the capture was dispatched.
- Editor playback with background music - Playback audio now works when your timeline has music but no recorded audio track.
- Mic volume meter accuracy - The microphone level meter no longer stalls or grows memory when an audio device's capture clock freezes.
- Recordings no longer stop mid-way with a writer error on macOS - When screen or microphone capture briefly stalled and then recovered in a burst, two frames could land on the same timestamp and the video writer would fail a few seconds later, ending the recording with an error. Frame timing is now corrected before it reaches the writer, so the recording continues. This affected instant, studio, and camera recordings, and was most likely with USB microphones whose capture clock can stall.
- The same timing issue fixed for instant recordings on Windows - Frames arriving in a burst could collide on a single timestamp tick and be rejected by the recorder. Timestamps are now kept strictly increasing, and a stuck capture clock is surfaced in logs instead of failing silently.
- Pause and resume reliability on macOS - Pausing a recording could occasionally produce overlapping frame timings that made the writer fail sporadically after resume. Recordings now survive repeated pause and resume cycles, including stopping while paused.
- Disk-space protection for every recording mode - Previously only instant recordings checked disk space. Every mode, including the camera track, now refuses to start without enough free space, warns when space runs low mid-recording, and stops cleanly before the disk fills so your recording is finalized and playable instead of corrupted.
- Camera recordings survive encoder errors - If the camera encoder hits an error mid-recording, the camera file is now finalized up to that point instead of being left unreadable.
- Fixed a freeze during the macOS screen-recording permission check - A deadlock in the permission check could hang the app when starting a recording.
Performance
- Lighter instant recordings on macOS - Instant recordings now capture at a size matched to the output resolution instead of the display's full Retina resolution, reducing CPU and memory use on high-density displays.
- Faster camera preview during instant recordings - The camera preview streams frames in a more efficient format while instant recording, lowering preview overhead.