Record a YouTube live stream to an MP4 on your Mac

By

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/Movies on 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.

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.

How Broadcast Keep records from the current pointYou paste a live YouTube link. The app checks the URL, runs yt-dlp with your browser's cookies until you click Stop Recording, then copies the downloaded media into one MP4 with FFmpeg and checks it before showing Recording saved.Paste the live linkCheck it's a YouTubeURLyt-dlp downloadsfrom now onStop RecordingFFmpeg copies themedia into one MP4Check the MP4Recording saved

Follow the status

The box under the link field tells you where the recording is:

TitleWhat it meansButtons
Preparing recording”Checking the stream…”, no video yetCancel
RecordingMedia is arriving, with elapsed time and download progressStop Recording
Finishing recording”Finalizing the video file…”, the MP4 is being madenone
Recording savedThe MP4 is done, its name is shownReveal in Finder, Record Another
Recording cancelledYou cancelled before any video arrivedTry Again
Recording failedThe error is shown in the boxTry 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.

Broadcast Keep showing Recording saved, with a file name that starts with 2026-11-04 18-43-29, and the Reveal in Finder and Record Another buttons

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.

More tutorials for my apps →

Want me to talk about your product? You can sponsor this site.