Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

yt-dlp

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
8.2 Club score Visit github.com

What yt-dlp is

yt-dlp is a free command-line tool for downloading audio and video from thousands of sites. Supported sources include YouTube, Bilibili, Dailymotion, Facebook, Vimeo, TikTok, and Twitch. It can download playlists, subtitles, and batches, and offers format selection for video and audio. Users can choose available formats and sort them, download by timestamps or chapters, or split downloads into chapter files. It can also mark or remove sponsor and other segments in YouTube videos using the SponsorBlock API. yt-dlp is a fork of youtube-dl based on the inactive youtube-dlc, and its public GitHub repository is licensed under the Unlicense. Standalone binaries are available for Windows, macOS, and Linux; Python is also supported. Full YouTube support requires yt-dlp-ejs. The project offers stable, nightly, and master binary channels, and older versions display a warning suggesting an update. It publishes checksum and signature files for release verification.

Who it suits

yt-dlp suits people comfortable using a command line who need downloads from supported online sources. It runs on Windows, macOS, and Linux, with Python support for embedding it in programs.

Good to know, and what to watch

  • Supports thousands of sites.
  • Downloads playlists, subtitles, and batches.
  • Offers a wide range of audio and video formats.
  • Can download selected timestamps or chapters.
  • Provides checksums and signatures for release verification.
  • Full YouTube support requires yt-dlp-ejs.
  • It is a command-line tool.
  • Python support requires CPython 3.10+ or PyPy 3.11+.
  • Versions older than 90 days display an update warning.

Free software

Free

Free plan

Getting started

  1. Open the yt-dlp GitHub repository
  2. Choose a standalone Windows or macOS release, or Linux binaries
  3. Use the platform-independent binary with Python when appropriate
  4. Install Python 3.10+ for CPython or PyPy 3.11+ if using the Python route
  5. Add ffmpeg, ffprobe, yt-dlp-ejs, and a supported JavaScript runtime for recommended dependencies
  6. Use the command line or embed yt-dlp through its YoutubeDL interface

Limits to check

The free software plan is free and has no stated usage limits or paid tiers. Full YouTube support requires yt-dlp-ejs; a supported JavaScript runtime is recommended.

The Club's review

yt-dlp is a command-line audio and video downloader for people who want detailed control over source, format, and download scope. Its broad extractor support and batch tools make it a strong choice for technically comfortable users, but those who want a graphical workflow should look elsewhere.

Overview

yt-dlp supports thousands of sites, including YouTube, Bilibili, Dailymotion, Facebook, Vimeo, TikTok, and Twitch. It began as a fork of youtube-dl based on the inactive youtube-dlc, and its public GitHub repository is marked Unlicense. The README notes that some bundled release binaries include third-party code under other licenses.

The project publishes stable, nightly, and master binary channels. Stable releases generally arrive on a mostly monthly schedule, and versions older than 90 days display an update warning. Nightly is recommended for regular users; master may contain bugs or regressions. SHA-256 and SHA-512 checksum files and GPG signature files, alongside a public key, give users a way to verify release files.

Key features

Format selection can choose and sort the available video and audio formats. The supported output formats span AVI, FLV, MKV, MOV, MP4, and WebM for video, plus AAC, AIFF, ALAC, FLAC, M4A, MKA, MP3, OGG, Opus, Vorbis, and WAV for audio. That range is useful when a particular container or audio format matters, though the command-line interface puts the work of making those choices on the user.

Playlist, batch, and subtitle downloads cover more than one-off clip saving. Configurable output templates and paths help organize downloaded files, while timestamp and chapter controls let users download selected portions or split a video into chapter files. These options suit repeatable or carefully scoped jobs, but require more setup than a simple download button.

For YouTube videos, yt-dlp can mark or remove sponsor and other segments through the SponsorBlock API. Full YouTube support requires yt-dlp-ejs, and the project recommends ffmpeg, ffprobe, and a supported JavaScript runtime as well. Browser-cookie extraction supports Brave, Chrome, Firefox, Safari, and Edge, which can help with sources accessed through a browser session.

Extractor and postprocessor plugins can extend the tool, and Python programs can embed it through the YoutubeDL interface. Plugin code is unchecked, so users should only install it when they trust its author. These capabilities make yt-dlp adaptable for automation, but also reward users who are comfortable managing dependencies and code.

Pricing

The Free software plan costs nothing. yt-dlp has no paid plans or stated usage limits, making it a practical option for individuals and teams that can work with its command-line setup. There is no free trial because the software is already free; the trade-off is that users do not get a graphical workflow as part of this offering.

Platforms

yt-dlp supports Linux, macOS, Windows, and self-hosted use. Standalone Windows binaries support Windows 8 or later in x64, x86, and ARM64 variants. Standalone macOS executables support macOS 10.15 or later. Linux binaries cover glibc and musl, with x86_64, aarch64, and armv7l variants. A platform-independent binary is also available but requires Python.

For users running it through Python, the project supports CPython 3.10+ and PyPy 3.11+. That flexibility is valuable across desktop and server setups, though users should account for the recommended dependencies and the required yt-dlp-ejs component for full YouTube support.

Who it's for

yt-dlp is best suited to users who are comfortable with a terminal and want control over formats, playlists, chapters, partial downloads, or recurring batch jobs. Developers can also embed it in Python programs, while self-hosters can use it without relying on a desktop-only workflow. First-time users who expect a point-and-click downloader may find the setup and command options an unnecessary hurdle.

Pros and cons

  • Pros: Support for thousands of sites and a wide range of video and audio formats makes it adaptable to varied sources and playback needs.
  • Pros: Playlist, batch, subtitle, chapter, and partial-download controls suit larger or more targeted jobs.
  • Pros: Standalone binaries and Python support cover multiple desktop platforms as well as self-hosted workflows.
  • Pros: Release checksums and GPG signatures provide a way to verify downloaded binaries.
  • Cons: The command-line approach is a poor fit for users who want to manage downloads through a graphical interface.
  • Cons: Full YouTube support requires yt-dlp-ejs, and recommended tools add setup work.
  • Cons: External plugins are unchecked, so extending the tool requires care about whom to trust.

Alternatives

If you want a desktop app built around yt-dlp rather than its command-line interface, yt-dlp app is a free option for Windows, macOS, and Linux with no telemetry or tracking. For a self-hosted free alternative with no paid plans, MeTube supports web access as well as several desktop and mobile platforms.

4K Video Downloader+ is worth considering if you want a freemium option with a permanent basic-features plan and a free trial. VidRivo may suit Windows users who want a dedicated app for YouTube and TikTok downloads, with its free mode capped at 1080p. For a free cross-platform choice that also includes Android and iOS, DownSnap offers no download limits and requires no sign-up.

OmniGet is another free option, with no ads, no account, and no paid plan. Yalla Video may appeal to desktop users seeking up to 8K output and up to 8 concurrent downloads. If you want browser-extension support, SSvid offers a free plan capped at 5 downloads per day. Browse more options in Video Downloaders.

Verdict

Choose yt-dlp if you want a free, highly configurable downloader that can handle diverse sources, formats, playlists, and partial downloads across desktop and self-hosted environments. Its main advantage is control; its main cost is the command-line learning curve and the extra dependency needed for full YouTube support. If you want a guided graphical experience, a desktop app such as yt-dlp app is the better fit.

The verdict

yt-dlp offers broad source and format support, plus controls for playlists, chapters, and partial downloads. Its command-line approach and YouTube dependency are worth accounting for before getting started.

Questions people ask

Is yt-dlp free?

Yes. The listed Free software plan costs nothing, with no paid plans stated.

Which platforms does it support?

Release files include Windows, macOS, and Linux executables, plus a platform-independent binary requiring Python.

What sources can it download from?

Supported extractors include YouTube, Bilibili, Dailymotion, Facebook, Vimeo, TikTok, Twitch, and many other sites.

Does it download playlists and subtitles?

Yes. Playlist downloads, subtitle downloads, and batch downloads are supported.

What license does the project use?

The repository is marked Unlicense; some bundled release binaries contain third-party code under other licenses.

What is required for full YouTube support?

yt-dlp-ejs is required, and a supported JavaScript runtime is recommended.

What the maker publishes

Batch downloads
Yes source
Browser cookies
It can extract cookies from supported browsers, including Brave, Chrome, Firefox, Safari, and Edge. source
Dependencies
Python 3.10+ is supported for CPython, and ffmpeg, ffprobe, yt-dlp-ejs, and a supported JavaScript runtime are recommended, with yt-dlp-ejs required for full YouTube support. source
Device platforms
Windows,macOS,Linux source
Embedding
The project documents embedding yt-dlp in Python programs through its YoutubeDL interface. source
Formats
Its format selection supports choosing and sorting available video and audio formats. source
Free plan
Yes source
Repository activity
The repository lists 24,009 commits, 16.8k forks, and 194k stars. source
Repository visibility
The GitHub repository is public. source
Integrity verification
Release checksums have SHA-512 and SHA-256 signature files with a GPG public key. source
Primary license
The project is licensed under the Unlicense. source
License
The repository is marked Unlicense, while the README explains that some bundled release binaries contain third-party code under other licenses. source
Linux support
Provides Linux binaries for glibc, musl, x86_64, aarch64, and armv7l variants. source
macOS support
Provides standalone macOS executables for macOS 10.15 or later. source
Version warning
Versions older than 90 days display a warning suggesting an update. source
Output formats
avi,flv,mkv,mov,mp4,webm,aac,aiff,alac,flac,m4a,mka,mp3,ogg,opus,vorbis,wav source
Partial downloads
Videos can be downloaded partially by timestamps or chapters, and split into multiple files by chapter. source
Playlists
It supports playlist downloads and configurable output templates and paths for downloaded files. source
Playlist downloads
Yes source
Plugins
Extractor and postprocessor plugins can be loaded from external files, but the project warns that plugin code is unchecked and should only be trusted if the user trusts its author. source
Pricing page
The repository pricing URL returns a page-not-found result. source
Project origin
A fork of youtube-dl based on the inactive youtube-dlc. source
Project type
A feature-rich command-line audio/video downloader. source
Purpose
yt-dlp is a feature-rich command-line audio/video downloader with support for thousands of sites. source

Checked against the maker's pages on 11 Oct 2026.