yt-dlp/yt-dlp Documentation

Guides

• CONTRIBUTING TO YT-DLP
• Changelog
• Collaborators
• Extractors
• FAQ
• Forks
• Installation
• PO Token Guide
• PULL_REQUEST_TEMPLATE
• Plugin Development
• Plugins
• Wiki Home
• instructions (Generate certificates for client cert tests)
• supportedsites (Supported sites)
• yt-dlp/yt-dlp

Sections

• 2021.01.05 - Changelog
• 2021.01.05-1 - Changelog
• 2021.01.07 - Changelog
• 2021.01.07-1 - Changelog
• 2021.01.08 - Changelog
• 2021.01.09 - Changelog
• 2021.01.10 - Changelog
• 2021.01.12 - Changelog
• 2021.01.14 - Changelog
• 2021.01.16 - Changelog
• 2021.01.20 - Changelog
• 2021.01.24 - Changelog
• 2021.01.29 - Changelog
• 2021.02.04 - Changelog
• 2021.02.09 - Changelog
• 2021.02.15 - Changelog
• 2021.02.19 - Changelog
• 2021.02.24 - Changelog
• 2021.03.01 - Changelog
• 2021.03.03 - Changelog
• 2021.03.03.2 - Changelog
• 2021.03.07 - Changelog
• 2021.03.15 - Changelog
• 2021.03.21 - Changelog
• 2021.03.24 - Changelog
• 2021.03.24.1 - Changelog
• 2021.04.03 - Changelog
• 2021.04.11 - Changelog
• 2021.04.22 - Changelog
• 2021.05.11 - Changelog
• 2021.05.20 - Changelog
• 2021.06.01 - Changelog
• 2021.06.08 - Changelog
• 2021.06.09 - Changelog
• 2021.06.23 - Changelog
• 2021.07.07 - Changelog
• 2021.07.21 - Changelog
• 2021.07.24 - Changelog
• 2021.08.02 - Changelog
• 2021.08.10 - Changelog
• 2021.09.02 - Changelog
• 2021.09.25 - Changelog
• 2021.10.09 - Changelog
• 2021.10.10 - Changelog
• 2021.10.22 - Changelog
• 2021.11.10 - Changelog
• 2021.11.10.1 - Changelog
• 2021.12.01 - Changelog
• 2021.12.25 - Changelog
• 2021.12.27 - Changelog
• 2022.01.21 - Changelog
• 2022.02.03 - Changelog
• 2022.02.04 - Changelog
• 2022.03.08 - Changelog
• 2022.03.08.1 - Changelog
• 2022.04.08 - Changelog
• 2022.05.18 - Changelog
• 2022.06.22 - Changelog
• 2022.06.22.1 - Changelog
• 2022.06.29 - Changelog
• 2022.07.18 - Changelog
• 2022.08.08 - Changelog
• 2022.08.14 - Changelog
• 2022.08.19 - Changelog
• 2022.09.01 - Changelog
• 2022.10.04 - Changelog
• 2022.11.11 - Changelog
• 2023.01.02 - Changelog
• 2023.01.06 - Changelog
• 2023.02.17 - Changelog
• 2023.03.03 - Changelog
• 2023.03.04 - Changelog
• 2023.06.21 - Changelog
• 2023.06.22 - Changelog
• 2023.07.06 - Changelog
• 2023.09.24 - Changelog
• 2023.10.07 - Changelog
• 2023.10.13 - Changelog
• 2023.11.14 - Changelog
• 2023.11.16 - Changelog
• 2023.12.30 - Changelog
• 2024.03.10 - Changelog
• 2024.04.09 - Changelog
• 2024.05.26 - Changelog
• 2024.05.27 - Changelog
• 2024.07.01 - Changelog
• 2024.07.02 - Changelog
• 2024.07.07 - Changelog
• 2024.07.08 - Changelog
• 2024.07.09 - Changelog
• 2024.07.16 - Changelog
• 2024.07.25 - Changelog
• 2024.08.01 - Changelog
• 2024.08.06 - Changelog
• 2024.09.27 - Changelog
• 2024.10.07 - Changelog
• 2024.10.22 - Changelog
• 2024.11.04 - Changelog
• 2024.11.18 - Changelog
• 2024.12.03 - Changelog
• 2024.12.06 - Changelog
• 2024.12.13 - Changelog
• 2024.12.23 - Changelog
• 2025.01.12 - Changelog
• 2025.01.15 - Changelog
• 2025.01.26 - Changelog
• 2025.02.19 - Changelog
• 2025.03.21 - Changelog
• 2025.03.25 - Changelog
• 2025.03.26 - Changelog
• 2025.03.27 - Changelog
• 2025.03.31 - Changelog
• APT) - Installation
• Active - Forks
• Add a custom PostProcessor - README
• Adding logger and progress hook - README
• Adding new feature or making overarching changes - CONTRIBUTING TO YT-DLP
• Adding support for a new site - CONTRIBUTING TO YT-DLP
• Almost redundant options - README
• Alpine Linux - Installation
• Alternatives - README
• Always extract audio - README
• Android - Installation
• Are you using the latest version? - CONTRIBUTING TO YT-DLP
• Are you willing to share account details if needed? - CONTRIBUTING TO YT-DLP
• Ashish0804 [Inactive] - Collaborators
• Authentication Options: - README
• Authentication with netrc - README
• Automated releases - Forks
• Before submitting a pull request make sure you have: - PULL_REQUEST_TEMPLATE
• CA - instructions (Generate certificates for client cert tests)
• CHANGES FROM YOUTUBE-DL - README
• COMPILE - README
• CONFIGURATION - README
• CONTRIBUTING - README
• Cases where a PO Token is required - PO Token Guide
• Changelog of blackjack4494/yt-dlc till release 2020.11.11-3 - Changelog
• Check out the yt-dlp-plugins GitHub topic for more - Plugins
• Chocolatey - Installation
• Client - instructions (Generate certificates for client cert tests)
• Collapse fallbacks - CONTRIBUTING TO YT-DLP
• Configuration file encoding - README
• Configuring your plugin package - Plugin Development
• Contributing to the wiki - Home
• Current PO Token enforcement - PO Token Guide
• DEPENDENCIES - README
• DEVELOPER INSTRUCTIONS - CONTRIBUTING TO YT-DLP
• Deprecated - README
• Deprecated options - README
• Description of your pull request and other information - PULL_REQUEST_TEMPLATE
• Developer options - README
• Developing Plugins - README
• Differences in default behavior - README
• Do I need any other programs? - FAQ
• Do not copy the mtime - README
• Do not misuse . and use the correct quantifiers (+*?) - CONTRIBUTING TO YT-DLP
• Does the issue involve one problem, and one problem only? - CONTRIBUTING TO YT-DLP
• Don’t capture groups you don’t use - CONTRIBUTING TO YT-DLP
• Download Options: - README
• Download using an info-json - README
• Downloading clips and cutting out Sponsor sections is inaccurate - FAQ
• EMBEDDING YT-DLP - CONTRIBUTING TO YT-DLP
• EMBEDDING YT-DLP - README
• EXTRACTOR ARGUMENTS - README
• Embedding examples - README
• Exporting YouTube cookies - Extractors
• Extract audio - README
• Extracting information - README
• Extractor - Plugins
• Extractor Options: - README
• FORMAT SELECTION - README
• File name too long - FAQ
• Filesystem Options: - README
• Filter videos - README
• Filtering Formats - README
• Forking the project - README
• Format Selection examples - README
• General Options: - README
• Geo-restriction: - README
• Getting Started - Plugin Development
• Grub4K - Collaborators
• Guide: Providing a PO Token manually (for use with web client) - PO Token Guide
• HTTP Error 429: Too Many Requests or 402: Payment Required - FAQ
• Have you read and understood the changes, between youtube-dl and yt-dlp - CONTRIBUTING TO YT-DLP
• Homebrew - Installation
• How can I detect whether a given URL is supported by yt-dlp? - FAQ
• How can I speed up work on my issue? - FAQ
• How do I create a plugin for yt-dlp? - Plugin Development
• How do I download a video starting with a -? - FAQ
• How do I download only new videos from a playlist? - FAQ
• How do I pass cookies to yt-dlp? - FAQ
• How do I put downloads into a specific folder? - FAQ
• How do I stream directly to media player? - FAQ
• How to use plugins? - Plugins
• I extracted a video URL, but it does not play on another machine / in my web browser - FAQ
• INSTALLATION - README
• Impersonation - README
• Importing extractors from other plugins - Plugin Development
• In order to be accepted and merged into yt-dlp each piece of code must be in public domain or released under Unlicense. Check those that apply and remove the others: - PULL_REQUEST_TEMPLATE
• Inactive - Forks
• Inline values - CONTRIBUTING TO YT-DLP
• Installing Plugins - README
• Installing the release binary - Installation
• Internet Shortcut Options: - README
• Introduction - PO Token Guide
• Is anyone going to need the feature? - CONTRIBUTING TO YT-DLP
• Is the description of the issue itself sufficient? - CONTRIBUTING TO YT-DLP
• Is the issue already documented? - CONTRIBUTING TO YT-DLP
• Is the website primarily used for piracy? - CONTRIBUTING TO YT-DLP
• Is there enough context in your bug report? - CONTRIBUTING TO YT-DLP
• Is your question about yt-dlp? - CONTRIBUTING TO YT-DLP
• I’m getting HTTP Error 403 and the site has an open issue on the tracker that’s labeled “Cloudflare-related”. What can I do? - FAQ
• Keep the regular expressions as simple as possible, but no simpler - CONTRIBUTING TO YT-DLP
• Known issues - FAQ
• Lines starting with # are comments - README
• Linux/MacOS - Installation
• Logging in with OAuth - Extractors
• Long lines policy - CONTRIBUTING TO YT-DLP
• MODIFYING METADATA - README
• MacPorts - Installation
• Make regular expressions relaxed and flexible - CONTRIBUTING TO YT-DLP
• Mandatory and optional metafields - CONTRIBUTING TO YT-DLP
• Metadata - README
• Modifying metadata examples - README
• My pull request is labeled pending-fixes - CONTRIBUTING TO YT-DLP
• Network Options: - README
• Networking - README
• New features - README
• No account - PO Token Guide
• No longer supported - README
• Not recommended - README
• Notes about environment variables - README
• OPENING AN ISSUE - CONTRIBUTING TO YT-DLP
• OUTPUT TEMPLATE - README
• Old aliases - README
• On Windows, how should I set up ffmpeg and yt-dlp? Where should I put the exe files? - FAQ
• Other - Plugins
• Other PO Token related tools - PO Token Guide
• Output template and Windows batch files - FAQ
• Output template examples - README
• PLUGINS - README
• PO Token Guide - Extractors
• PO Token for GVS - PO Token Guide
• PO Token for Player - PO Token Guide
• PO Tokens for GVS - PO Token Guide
• PO Tokens for Player - PO Token Guide
• Passing Visitor Data without cookies - Extractors
• Platform-independent Binary (UNIX) - README
• Plugins - PO Token Guide
• Poetry configuration - Plugin Development
• Post-Processing Options: - README
• Postprocessor - Plugins
• Provide fallbacks - CONTRIBUTING TO YT-DLP
• Quotes - CONTRIBUTING TO YT-DLP
• RELEASE FILES - README
• Recommended - README
• Redundant options - README
• Regular expressions - CONTRIBUTING TO YT-DLP
• Related scripts - README
• Removed - README
• Run and debug configuration - Plugin Development
• Save all videos under YouTube directory in your home directory - README
• Scoop - Installation
• Snap - Installation
• Sorting Formats - README
• Sponskrub Options - README
• SponsorBlock Options: - README
• Standalone PyInstaller Builds - README
• Strongly recommended - README
• Subtitle Options: - README
• Technical details - PO Token Guide
• The yt-dlp in my Package Manager is outdated/broken - FAQ
• Third-party package managers - Installation
• Thumbnail Options: - README
• To install nightly with pip: - README
• To update to nightly from stable executable/binary: - README
• Trailing parentheses - CONTRIBUTING TO YT-DLP
• UPDATE - README
• USAGE AND OPTIONS - README
• Unreleased changes in blackjack4494/yt-dlc - Changelog
• Use a custom format selector - README
• Use convenience conversion and parsing functions - CONTRIBUTING TO YT-DLP
• Use this proxy - README
• Verbosity and Simulation Options: - README
• Video Format Options: - README
• Video Selection: - README
• Video URL contains an ampersand & and I’m getting some strange output [1] 2839 or 'v' is not recognized as an internal or external command - FAQ
• WIKI - README
• Welcome to the yt-dlp wiki! - Home
• What does “sites primarily used for piracy” mean? - FAQ
• What is the purpose of your pull request? Check those that apply and remove the others: - PULL_REQUEST_TEMPLATE
• Why am I getting an incorrect codec parameters error from ffmpeg when downloading or postprocessing? - FAQ
• Why are existing options not enough? - CONTRIBUTING TO YT-DLP
• Why do I need to go through that much red tape when filing bugs? - FAQ
• Why is there a rule against websites “primarily used for piracy”? - FAQ
• Windows - Installation
• With an account - PO Token Guide
• With pip - Installation
• Workarounds: - README
• YouTube - Extractors
• YouTube PO Token Guide - PO Token Guide
• afreecatvlive - README
• bashonly - Collaborators
• bilibili - README
• coletdjnz - Collaborators
• gamejolt - README
• generic - README
• hotstar - README
• instagram - README
• jiocinema - README
• jiosaavn - README
• nflplusreplay - README
• nhkradirulive (NHK らじる★らじる LIVE) - README
• niconico - README
• niconicochannelplus - README
• orfon (orf:on) - README
• pacman - Installation
• pukkandan - Collaborators
• rokfinchannel - README
• sepro - Collaborators
• shirt - Collaborators
• sonylivseries - README
• soundcloud - README
• stacommu, wrestleuniverse - README
• tiktok - README
• tver - README
• twitch - README
• twitter - README
• vikichannel - README
• winget - Installation
• youtube - README
• youtubetab (YouTube playlists, channels, feeds, etc.) - README
• youtubewebarchive - README
• yt-dlp coding conventions - CONTRIBUTING TO YT-DLP