yt-dlp is a feature-rich command-line audio/video downloader with support for thousands of sites. The project is a fork of youtube-dl based on the now inactive youtube-dlc.

• INSTALLATION
  • Detailed instructions
  • Release Files
  • Update
  • Dependencies
  • Compile
• USAGE AND OPTIONS
  • General Options
  • Network Options
  • Geo-restriction
  • Video Selection
  • Download Options
  • Filesystem Options
  • Thumbnail Options
  • Internet Shortcut Options
  • Verbosity and Simulation Options
  • Workarounds
  • Video Format Options
  • Subtitle Options
  • Authentication Options
  • Post-processing Options
  • SponsorBlock Options
  • Extractor Options
  • Preset Aliases
• CONFIGURATION
  • Configuration file encoding
  • Authentication with netrc
  • Notes about environment variables
• OUTPUT TEMPLATE
  • Output template examples
• FORMAT SELECTION
  • Filtering Formats
  • Sorting Formats
  • Format Selection examples
• MODIFYING METADATA
  • Modifying metadata examples
• EXTRACTOR ARGUMENTS
• PLUGINS
  • Installing Plugins
  • Developing Plugins
• EMBEDDING YT-DLP
  • Embedding examples
• CHANGES FROM YOUTUBE-DL
  • New features
  • Differences in default behavior
  • Deprecated options
• CONTRIBUTING
  • Opening an Issue
  • Developer Instructions
• WIKI
  • FAQ

INSTALLATION

You can install yt-dlp using the binaries, pip or one using a third-party package manager. See the wiki for detailed instructions

RELEASE FILES

Recommended

Alternatives

Misc

The public key that can be used to verify the GPG signatures is available here Example usage:

curl -L https://github.com/yt-dlp/yt-dlp/raw/master/public.key | gpg --import
gpg --verify SHA2-256SUMS.sig SHA2-256SUMS
gpg --verify SHA2-512SUMS.sig SHA2-512SUMS

Licensing

While yt-dlp is licensed under the Unlicense, many of the release files contain code from other projects with different licenses.

Most notably, the PyInstaller-bundled executables include GPLv3+ licensed code, and as such the combined work is licensed under GPLv3+.

The zipimport Unix executable (yt-dlp) and release tarball (yt-dlp.tar.gz) contain ISC licensed code from meriyah and MIT licensed code from astring.

See THIRD_PARTY_LICENSES.txt for more details.

The git repository, the PyPI source distribution and the PyPI built distribution (wheel) only contain code licensed under the Unlicense.

Note: The manpages, shell completion (autocomplete) files etc. are available inside the [source tarball](https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp.t