yt-dlp Windows Helper
Unofficial, community-driven

FFmpeg for Windows — Setup for yt-dlp

Enable 4K/8K video+audio merges and MP3 conversions by adding ffmpeg.exe to your Windows setup. The fastest, simplest way is to place ffmpeg.exe next to yt-dlp.exe.

⬇️ Get FFmpeg for Windows Get yt-dlp.exe

Note: Windows builds are provided by trusted community maintainers listed on the official FFmpeg site. Choose a recent build and extract it locally.
• Works on Windows 11/10

Quick setup (recommended)

  1. Download a Windows build from the official FFmpeg downloads page.
  2. Extract the archive and locate ffmpeg.exe (usually in the bin folder).
  3. Copy ffmpeg.exe into the same folder as yt-dlp.exe.
  4. Test a 4K video; you should see [ffmpeg] Merging formats in the output.

Verify FFmpeg is detected

Run a quick download in PowerShell:

yt-dlp -f "bestvideo+bestaudio/best" "https://www.youtube.com/watch?v=VIDEO_ID"

Look for [ffmpeg] Merging formats. Alternatively, check via:

ffmpeg -version

(Optional) Add FFmpeg to PATH

  • GUI: Environment Variables → User variables → Path → New → paste FFmpeg bin folder → OK.
  • PowerShell (current user): setx PATH "%PATH%;C:\\Path\\to\\ffmpeg\\bin" (restart terminal).

PATH is optional for yt-dlp if ffmpeg.exe is next to the executable.

Best practices

  • Keep FFmpeg updated to the latest stable build for codec fixes and performance.
  • Place ffprobe.exe alongside ffmpeg.exe for advanced format detection (optional).
  • Store yt-dlp.exe and ffmpeg.exe in a dedicated folder like C:\\Tools\\yt-dlp.

Common pitfalls

  • “ffmpeg not found”: Ensure ffmpeg.exe is in the same folder as yt-dlp.exe or added to PATH.
  • Merge errors: Update FFmpeg and yt-dlp; verify files are not blocked by antivirus; redownload if corrupted.
  • No artwork/tags in MP3: Include --embed-thumbnail --embed-metadata and ensure FFmpeg is present.

FAQ

Is FFmpeg required for every download?

No. It's required for merging separate video/audio (common in 4K/8K) and for converting audio (e.g., MP3). For simple single-stream downloads, yt-dlp can still work without it.

Where should I place ffprobe.exe?

In the same folder as ffmpeg.exe is ideal. yt-dlp can use ffprobe for better format detection, but it's optional.

Can I use PATH instead of copying next to yt-dlp.exe?

Yes. Add the FFmpeg bin folder to PATH. yt-dlp will find it system-wide.