Record a YouTube live stream to an MP4 on your Mac
By Flavio
Updated
Record a YouTube live stream you own or may save, from the moment you paste the link, and get a finished MP4 with Broadcast Keep, yt-dlp and FFmpeg.
A stream is live on YouTube right now, and you want it on your Mac as an MP4 file. Your own stream, your company’s, or one whose owner said you can keep a copy. Those are the only streams to record.
YouTube can archive a live stream for you, but only if it’s under 12 hours, and that same page recommends recording a local archive as a backup. Broadcast Keep makes that local copy while the stream runs.
This tutorial records from the moment you paste the link. If you joined late and want the part you missed, read Save a YouTube live stream from its beginning after this one.
Install the recording tools
Broadcast Keep runs on macOS 14 or later, on Apple silicon and Intel. It does the recording with three command-line tools you install with Homebrew (my Homebrew guide if you don’t have it yet):
brew install yt-dlp ffmpeg deno
yt-dlp downloads the stream. FFmpeg turns what it downloaded into one MP4, and it installs ffprobe too. Deno is the JavaScript runtime yt-dlp uses for YouTube.
Check that each one answers:
yt-dlp --version
ffmpeg -version | head -1
deno --version | head -1
2026.07.04
ffmpeg version 9.0.2 Copyright (c) 2000-2026 the FFmpeg developers
deno 2.6.5 (stable, release, aarch64-apple-darwin)
The app looks for them on your PATH and in ~/.local/bin, ~/.deno/bin, ~/bin, /opt/homebrew/bin, /usr/local/bin and /usr/bin. If one is missing, the window shows a Recording tools required box with the exact brew install line for what’s missing. Install it and click Check Again.
If you get stuck, follow the recording tools setup guide. Broadcast Keep checks for app updates once a day. Update the recording tools separately with brew upgrade yt-dlp ffmpeg deno.
Set the three options
The window has three settings above the link field, and it remembers all of them for the next recording:
- Start recording: From current point records from the moment you paste the link. Leave it there for this tutorial.
- Save to: the folder for the MP4. It starts as your Movies folder,
/Users/flaviocopes/Movieson my Mac. Choose… picks another one. - YouTube sign-in: Use cookies from Google Chrome, Safari, Firefox, Brave or Arc. Google Chrome is the default.
The browser choice goes to yt-dlp as --cookies-from-browser on every recording, public streams included, so pick a browser you have and are signed in to YouTube with. macOS may ask permission the first time yt-dlp reads that browser’s cookies. The app stores which browser you picked, never the cookies.
For a members-only stream on your channel, or a private company stream shared with your account, this setting is what makes it work. If the stream doesn’t play in that browser, it won’t record either.
Paste the link
Copy the stream’s URL from the browser’s address bar and paste it into YouTube livestream URL. A pasted link starts the recording right away. A typed link waits until you press Return or click Record, so a half-typed address never starts anything.
The app accepts youtube.com and its subdomains, and youtu.be short links. Anything else gets “Broadcast Keep currently supports YouTube URLs only.”
It also only records something that is live right now. The command it runs includes --match-filter is_live, so a finished stream or a normal video gets skipped by yt-dlp.
Follow the status
The box under the link field tells you where the recording is:
| Title | What it means | Buttons |
|---|---|---|
| Preparing recording | ”Checking the stream…”, no video yet | Cancel |
| Recording | Media is arriving, with elapsed time and download progress | Stop Recording |
| Finishing recording | ”Finalizing the video file…”, the MP4 is being made | none |
| Recording saved | The MP4 is done, its name is shown | Reveal in Finder, Record Another |
| Recording cancelled | You cancelled before any video arrived | Try Again |
| Recording failed | The error is shown in the box | Try Again |
Under the box, Recording details opens the last eight [youtube] and [download] lines from yt-dlp. That’s the first place to look when something stops.
A recording runs as long as the stream does. Keep the Mac awake for a long one, and check the free space in the destination folder before you start.
Stop and find the MP4
When the stream ends, or you have the part you need, click Stop Recording.
The app interrupts yt-dlp the same way Control-C does, so it can close its files. If it hasn’t stopped after 8 seconds, the app terminates it and adds “Recording process did not stop cleanly and was terminated.” to the details.
Then FFmpeg copies the video and audio into one MP4. It’s a stream copy with -c copy, nothing is re-encoded, so it’s quick even for a long recording. The app checks that the result isn’t empty and that it really is an MP4, and only then shows Recording saved.

That screenshot is from the demo on the app page, a made-up surf cam stream served by a stand-in for yt-dlp. The file name follows the real pattern: the date and time you started, the stream title, and the video ID in brackets.
2026-11-04 18-43-29 Ribeira d’Ilhas morning session (live) [tdp7SurfCam].mp4
Click Reveal in Finder to see it. Record Another clears the link and keeps the mode, the folder and the browser.
If you quit Broadcast Keep while it’s recording, it stops the recording and finishes the MP4 before it quits.
Check the file
Open the MP4 and skip through it, with the sound on. To see what’s inside without playing it, ask ffprobe for the tracks and the duration:
ffprobe -v error -show_entries format=duration:stream=codec_type,codec_name -of json "2026-11-07 10-15-30 Morning session (live) [tdp7SurfCam].mp4"
This is the output for a one-minute test file with H.264 video and AAC audio:
{
"programs": [
],
"stream_groups": [
],
"streams": [
{
"codec_name": "aac",
"codec_type": "audio"
},
{
"codec_name": "h264",
"codec_type": "video"
}
],
"format": {
"duration": "60.000000"
}
}
You want one video stream and one audio stream. The duration is the media that was saved, so for a current-point recording it should be close to how long you recorded.
If it doesn’t work
Broadcast Keep cannot write to the selected folder. Choose another destination. means the app couldn’t create a file in Save to. Pick a folder you own, like one inside Movies.
“YouTube returned no formats yet. Retrying in 4 seconds (1/2)…” in the details happens right after a stream goes live. The app retries twice by itself.
Recording failed with “Recording ended unexpectedly (exit code 0).” and no file usually means the link wasn’t live, like a stream that already ended or a regular video.
An error about cookies or sign-in means the browser in YouTube sign-in isn’t the one where you’re signed in. Switch it, check that the stream plays there, and click Try Again.
A stream that recorded fine last month and now fails with an extractor error usually needs a newer yt-dlp, because YouTube changes and yt-dlp follows it:
brew upgrade yt-dlp ffmpeg deno
If ffmpeg is the one that can’t be found when you use yt-dlp from Terminal, I explain that error in How to fix the ffmpeg not found error.
Get Broadcast Keep
Record a YouTube live stream to an MP4 on your Mac, from now or from the earliest part YouTube still has, even if you joined late.
See Broadcast Keep → · Read the docs · $20. See the app page for tax details.
Want me to talk about your product? You can sponsor this site.