Recording Recovery: How Highlight Studio Protects Your Work

Why recordings sometimes fail

Screen recording on macOS relies on a system service called ScreenCaptureKit. It works great most of the time — but there are a handful of situations where macOS itself can interrupt or kill the capture without warning:

Your Mac went to sleep or the lid closed mid-recording.
The display was disconnected — unplugging an external monitor you were recording, for example.
The window you were recording was closed or the app quit.
Screen recording permission was revoked mid-session.
The GPU reset or memory pressure caused macOS to kill the stream.

Historically, any of these would silently destroy the recording — because a video file has to be properly "finalized" to be playable, and if capture dies mid-way, that finalization never happens. The file ends up on disk but can't be opened.

We've built several protections specifically to make sure this doesn't happen to your work.

What happens when something goes wrong

We save whatever was already recorded

When the screen capture stream dies unexpectedly, Highlight Studio immediately tries to salvage the recording. We take whatever frames have been successfully captured up to that moment and finalize the video file properly so you can still open and edit it.

If the salvage succeeds, you'll see a toast notification like "Recording Recovered — Screen capture stopped unexpectedly but 38s was saved. Your recording is ready to edit." — and the app will open the recovered recording in the editor automatically.

We detect sleep before it happens

If your Mac is about to go to sleep while you're recording, Highlight Studio catches the sleep event and finalizes the recording before the system suspends. When you wake your Mac, the recording will be waiting for you in the editor.

We monitor the recording every 5 seconds

A health-check runs continuously while you're recording. If frames stop being captured — even without an explicit error from macOS — we detect the stall and surface a warning so you know something's wrong instead of discovering it later.

We protect the camera recording too

If you were recording with the camera overlay enabled, the camera file is also salvaged and reconnected to the project automatically. Your mic audio, captured to a separate sidecar file, is also preserved and stays in sync with both the screen and camera tracks.

What you should do

Don't panic if you see an error. In most cases the recording has already been saved — the editor will open it automatically within a few seconds of the failure.
Check your recordings folder if the app didn't open the recovered file automatically. Files are saved in ~/Library/Application Support/Highlight Studio/Recordings/ with a timestamp in the filename.
Save the project immediately after a recovered recording opens. A salvaged recording is still a regular project — save it to a safe location so you don't risk losing it again.
Send us a log file if something was lost or didn't recover cleanly. From the editor, go to Help → Share Logs with Support. The log includes diagnostic information about what failed, which helps us reproduce and fix the issue.

What doesn't get recovered

There are two edge cases where recovery isn't possible:

The recording was less than half a second long when the failure occurred. There's not enough video data to produce a valid file.
The app itself crashed (as opposed to the capture stream dying). If Highlight Studio quits unexpectedly, the in-flight recording can't be finalized. This is rare — if it happens to you, please send us a crash report so we can investigate.

A note from the team

Losing a recording is genuinely frustrating, especially if you just captured something important. We take this seriously and keep improving the recovery paths every release. If you've experienced a lost recording and have the log file, please send it to us — each real-world failure we see helps us harden the app for everyone.

Your work matters. We're committed to keeping it safe.