ytdl-org /youtube-dl

Command-line program to download videos from YouTube.com and other video sites

★ 141,569⑂ 10,688👁 2,136⑃ 5,027● 26,833▤ 341
PythonUnlicenseCreated 2010-10-31ytdl-org.github.io/youtube-dl/
Download: youtube-dl 2021.12.17youtube-dl-2021.12.17 ↓2021.12.172021-12-16
+9
Daily
+68
Weekly
141,569
stars
10,688
forks
2,136
watchers
5,027
prs
26,833
issues
341
releases

README

youtube-dl - download videos from youtube.com or other video platforms

- INSTALLATION
- DESCRIPTION
- OPTIONS
- CONFIGURATION
- OUTPUT TEMPLATE
- FORMAT SELECTION
- VIDEO SELECTION
- FAQ
- DEVELOPER INSTRUCTIONS
- EMBEDDING YOUTUBE-DL
- BUGS
- COPYRIGHT

 INSTALLATION

To install it right away for all UNIX users (Linux, macOS, etc.), type:

    sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl -o /usr/local/bin/youtube-dl
    sudo chmod a+rx /usr/local/bin/youtube-dl

If you do not have curl, you can alternatively use a recent wget:

    sudo wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl
    sudo chmod a+rx /usr/local/bin/youtube-dl

Windows users can download an .exe file and place it in any location on their PATH except for %SYSTEMROOT%\System32 (e.g. do not put in C:\Windows\System32).

You can also use pip:

    sudo -H pip install --upgrade youtube-dl

This command will update youtube-dl if you have already installed it. See the pypi page for more information.

macOS users can install youtube-dl with Homebrew:

    brew install youtube-dl

Or with MacPorts:

    sudo port install youtube-dl

Alternatively, refer to the developer instructions for how to check out and work with the git repository. For further options, including PGP signatures, see the youtube-dl Download Page.

 DESCRIPTION
youtube-dl is a command-line program to download videos from YouTube.com and a few more sites. It requires the Python interpreter, version 2.6, 2.7, or 3.2+, and it is not platform specific. It should work on your Unix box, on Windows or on macOS. It is released to the public domain, which means you can modify it, redistribute it or use it however you like.

    youtube-dl [OPTIONS] URL [URL...]

 OPTIONS
    -h, --help                           Print this help text and exit
    --version                            Print program version and exit
    -U, --update                         Update this program to latest version.
                                         Make sure that you have sufficient
                                         permissions (run with sudo if needed)
    -i, --ignore-errors                  Continue on download errors, for
                                         example to skip unavailable videos in a
                                         playlist
    --abort-on-error                     Abort downloading of further videos (in
                                         the playlist or the command line) if an
                                         error occurs
    --dump-user-agent                    Display the current browser
                                         identification
    --list-extractors                    List all supported extractors
    --extractor-descriptions             Output descriptions of all supported
                                         extractors
    --force-generic-extractor            Force extraction to use the generic
                              

Top issues

Latest release

youtube-dl 2021.12.17 2021.12.17 2021-12-16
This release is old and has many known issues. See "... commits to master since this release" above.

You almost certainly want the nightly build release, and not this one. The nightly build is created from the master branch of this repo if changes have been committed since the last build. Read about Installation of the nightly build. Major fixes in the nightly build are listed here.

Core
 [postprocessor/ffmpeg] Show ffmpeg output on error (22680, 29336)

Extractors
 [youtube] Update signature function patterns (30363, 30366)
 [peertube] Only call description endpoint if necessary (2

News & coverage (20)

Hacker NewsYouTube-dl can no longer download age-restricted videos▲ 596 · 445 comments · 2021-06-01Hacker NewsYouTube-dl's first release since June 2021▲ 339 · 106 comments · 2021-12-17Hacker NewsMove myself to inactive▲ 278 · 140 comments · 2021-12-19Hacker NewsYouTube-dl is under new management, will be happy to see new PRs▲ 163 · 58 comments · 2022-01-29Hacker NewsYouTube throttling download through yt-dl▲ 29 · 4 comments · 2021-11-02Hacker NewsCommand-line program to download videos from YouTube.com and other video sites▲ 8 · 5 comments · 2020-03-06Hacker NewsCommand-line program to download videos from YouTube▲ 5 · 2 comments · 2019-07-03ZDNetGitHub reinstates youtube-dl library after EFF intervention2020-11-16BleepingComputerGitHub reinstates YouTube-dl, promises to overhaul DMCA reviews2020-11-16torrentfreakGitHub Reinstates Youtube-DL and Puts $1M in Takedown Defense Fund2020-11-16
10 morePC MagazineGitHub Restores Youtube-dl, a Video Downloading Tool Ensnared in DMCA Dispute2020-11-16VICEYoutube-dl is Back on Github: ‘Our Priority Is Supporting Open Source’2020-11-16TechCrunchGitHub defies RIAA takedown notice, restoring YouTube-dl and starting $1M defense fund2020-11-16XDA DevelopersGitHub reinstates YouTube-DL after EFF intervention2020-11-15XDA DevelopersGitHub warns of bans for users still distributing YouTube-DL2020-11-03mediasat.infoMusic industry asks EU to add YouTube downloader yt-dlp to its piracy watch list2026-10-01Plisioyt-dlp Guide 2026 : Install, Commands, Legal Status2026-05-08Electronic Frontier FoundationGitHub Reinstates youtube-dl After RIAA’s Abuse of the DMCA2020-11-17The GitHub BlogStanding up for developers: youtube-dl is back2020-11-16Ars TechnicaGitHub boots popular YouTube download tool after RIAA claim2020-10-26

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON