mrkeyoor.comAsk

yt-dlp/yt-dlptested 14 Nov 2026commit 412e7f0

yt-dlp review

Use yt-dlp for recurring permitted-media backups when archive files, format selection and repeatable commands justify maintaining helper tools and updates.

  • Install 1.3 s
  • README snippet failed
290/490passed, run exited non-zero
  • 12.0 MB on disk
  • 0 dependencies
Automationevaluationupdated 18 Nov 2026
+1,258stars / 7d

yt-dlp is a command-line audio and video downloader. Its documented controls include download archives, format selection and output templates; descriptions and captions can accompany the media.

Verdict

Use yt-dlp for recurring permitted-media backups when archive files, format selection and repeatable commands justify maintaining helper tools and updates. Our source build succeeded in 3 seconds, the test command failed, and the separate README task stopped at authentication. People who need desktop controls should choose a separate graphical wrapper. Operators who require translated captions with every download should not accept video completion alone as a successful archive.

yt-dlp infographic: download audio and video with descriptions and captions, plus our test result and who it suits
Tested 18 November 2026: the README snippet failed with "yt_dlp.utils.DownloadError". Before that: 14 Nov: 290 of 490 source tests passed; uv install took 1.3 s.

We ran it

Lab card: what happened when we ran yt-dlp
Lab card from our sandbox run
Screenshot of yt-dlp (discord.gg/H5MNcFW63r)
discord.gg/H5MNcFW63r
Install✓ · 20s36 packages · 38 MB
Build✓ · 3s
Tests✗ · 772s290 passed · 200 failed · 48 skipped of 490 (pytest)
Known vulns0(pip-audit)
Repo1230 files~248,292 lines of source · 12.3 MB · 13 CI workflows · tests dir

Answers from our run

Does yt-dlp build from source?

Dependencies installed in 20 seconds (36 packages), and the build succeeded in 3 seconds. We cloned commit 412e7f0 into a clean Debian container with 3 CPUs and no project-specific setup.

Do yt-dlp's tests pass?

No. The project's own test command finished in 772 seconds and reported 290 passed, 200 failed, 48 skipped (pytest).

Does yt-dlp have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use yt-dlp?

People who need a desktop interface in the core application; graphical wrappers are separate projects.

What are the alternatives to yt-dlp?

youtube-dl, FFmpeg, Stacher. Use yt-dlp for recurring permitted-media backups when archive files, format selection and repeatable commands justify maintaining helper tools and updates.

Setup3/5In our 2026-11-18 run it installed in 1.3 s, but the README’s “Extracting information” example failed as written with “yt_dlp.utils.DownloadError: ERROR: [youtube] YE7VzlLtp-4: Sign in to…”.Editor’s note: Installation and building succeeded, while the separate README task failed at authentication; these outcomes do not supply a complete setup assessment.
Docs2/5The 10,056-character README has no usage instructions or examples, and its example failed as written in our 2026-11-18 run.Editor’s note: The supplied README documents installation routes, dependencies and updates, but the record contains no complete documentation assessment against the site rubric.
Community5/5Last push on 2026-11-17, 208,696 stars and maintainers answered or closed 10 of the 10 most-discussed issues we sampled.Editor’s note: Sampled issues contain maintainer advice and mixed user outcomes, without representative support-response or adoption measurements.
Maturity4/5Latest release 2026.10.26 on 2026-10-26, repository created 2020-10-26 and its test suite did not pass in our sandbox (290 of 490 passed).Editor’s note: The harness records CI files and a tests directory alongside a failed test command; this does not supply a complete production-reliability assessment.

How we score

Discussed on

  1. hnYt-dlp: Upcoming new requirements for YouTube downloads1,244 points
  2. hnYt-dlp: External JavaScript runtime now required for full YouTube support1,106 points
  3. hnYt-dlp – A YouTube-dl fork with additional features and fixes822 points
  4. hnBun support is now limited and deprecated594 points
  5. hnYouTube DRM added on ALL videos with TV (TVHTML5) clients410 points

Who it’s for

Creators backing up their own media with descriptions and a download archive.
People collecting permitted playlists who want control over formats and metadata.
Developers prepared to maintain download commands, helper tools and update channels.

Who it’s NOT for

People who need a desktop interface in the core application; graphical wrappers are separate projects.
Operators whose acceptance criteria require translated captions whenever a video downloads successfully.
People seeking a download workflow that requires no ongoing attention to source-site changes.

Setup reality

Our November 14 sandbox run at commit 412e7f0 installed in 20 seconds with 36 dependencies recorded and 38 MB on disk. Building succeeded in 3 seconds. Tests exited 1 after 772 seconds, with 290 passed, 200 failed and 48 skipped reported. pip-audit recorded 0 known vulnerabilities across 36 scanned packages. Bandcamp failures named unavailable impersonation targets; Bandlab failures included metadata differences, missing playlist data and HTTP 403; BannedVideo returned HTTP 410.

Our separate November 18 run recorded checkout 2d596f4882a2 and installed PyPI release 2026.10.26 in 1.3 seconds. Its site-packages footprint was 12.0 MB, with 0 packages besides yt-dlp installed. The unedited README Python task failed after 2 seconds when YouTube requested sign-in confirmation. These are separate installation scopes and measurements.

The supplied current README supports Python 3.11+. FFmpeg and ffprobe handle merging and post-processing. Full YouTube support requires yt-dlp-ejs and a supported JavaScript runtime. Official executables bundle the JavaScript components; pip installations use the default extra. Windows has a standalone executable, so a package manager is optional.

Short answer

Our source build succeeded in 3 seconds, but the test command failed; a separate README task stopped at YouTube authentication after 2 seconds. Use yt-dlp for recurring permitted-media backups when archive files and format controls justify maintaining a command-line workflow. Choose a separate desktop wrapper if you need buttons and menus. Operators who require translated captions with every video should treat caption completion as its own acceptance criterion.

The strongest practical example in the supplied accounts is a creator backing up podcast episodes with their original audio, descriptions and a persistent download archive. That is a specific reason to choose configurable download commands: a repeat job needs to remember earlier downloads and retain the accompanying information. The Spacebar creator-backup account supplies that workflow, while our recorded runs supply installation, build and failure results for the review.

What people use yt-dlp for

The Spacebar author reports using yt-dlp for podcast backups, music playlists and searchable captions. Each task produces something different: original audio with descriptions, converted music with metadata, or subtitle text for searching. The official yt-dlp README documents the command-line controls. The accounts below describe individual authors' uses of those controls and identify the files they wanted to keep.

Person and task Reported outcome
The Spacebar author backed up their Tech Tales podcast from its RSS feed. The folder contained original audio and full episode descriptions; the archive file prevented repeat downloads. Podcast backup account.
The Spacebar author downloaded Vikas Music's Eurobeat remix playlist. The resulting MP3 files imported into a local library with artwork, titles and artist metadata. Music workflow.
The Spacebar author downloaded captions as SRT files. Text search helped locate words and topics within videos. Caption workflow.
The Tanzi Media author made separate Windows audio and video batch launchers. Reusable launchers reduced repeated command entry and confusion about output locations. Windows launcher account.

For the podcast backup, the Spacebar author used --write-description --download-archive downloaded.txt. The description option retained episode text, while the archive file recorded downloaded items for later runs. The author reports a folder containing the original audio and full descriptions, with earlier episodes skipped on repeat runs. A recurring collection therefore has both saved files and a persistent record that the next invocation uses. Podcast command and outcome.

The Mac-app creator newomp4 reports nearly daily use over several months of an application built around yt-dlp. Its advertised clipping, bulk downloading and timeline features belong to that application. The Tanzi Media account takes a simpler approach by putting commands into reusable launchers. These accounts show two ways people reduce repeated terminal work: place an interface around the downloader or save the commands they already use. Mac application account, Windows launcher account.

What happened when we ran it

Our November 18 README task failed after 2 seconds with YouTube's request to sign in and confirm the client was not a bot. The recorded checkout was 2d596f4882a2; the installed PyPI release was 2026.10.26. The unprivileged container had 2 CPUs, 4 GB RAM, no published ports and no secrets. The recipe ran the 12-line Python block from "Extracting information" unedited.

Question Answer Verdict Why
Did the quickstart clone step complete? The clone step recorded 2 seconds. Recorded The quickstart-lib recipe proceeded to installation.
What package did the recipe install? PyPI yt-dlp 2026.10.26 installed in 1.3 seconds. Installed The installation command was uv pip install yt-dlp in a fresh virtual environment.
What was the installed footprint? Site-packages occupied 12.0 MB. Measured The size step measured the virtual environment's site-packages after installation.
How many additional packages were installed? 0 packages besides yt-dlp. Measured This was the bare PyPI installation used by this recipe.
Did the unedited README Python example complete? Exit 1 after 2 seconds, with an authentication request. Failed A DownloadError named YouTube video YE7VzlLtp-4 and requested browser cookies or a cookie file.
Did sandbox teardown complete? Teardown recorded as OK. Completed The supplied run includes a successful teardown record.

The error requested --cookies-from-browser or --cookies for authentication. The installed package that produced that error was PyPI release 2026.10.26; 2d596f4882a2 identifies the repository checkout used by the recipe. Keeping both identifiers makes the example's provenance clear without treating the checkout and installed wheel as the same artifact. The run stopped at that authentication request.

Our November 14 source harness used commit 412e7f0, 3 CPUs and 8 GB RAM, with image label ghcr.io/astral-sh/uv:python3.12-bookworm. We measured installation and building separately from the test command. The checkout contained 1,230 files, approximately 248,292 source lines and 12.3 MB of repository files. The harness also recorded 13 CI workflow files, a tests directory and no Dockerfile.

Source-harness step Recorded result
Install Succeeded in 20 seconds; 36 dependencies recorded; 38 MB on disk
Build Succeeded in 3 seconds
Tests Exit 1 after 772 seconds; 290 passed, 200 failed and 48 skipped reported
Dependency audit pip-audit reported 0 known vulnerabilities; the JSON records 36 scanned packages

The parser's total field is 490, equal to 290 passed plus 200 failed before adding 48 skipped cases. The retained pytest tail separately reports 39 passed subtests and 768.78 seconds, while the outer test step records 772 seconds. The table preserves the outer duration and parsed counts; the retained tail adds the subtest result and pytest's own duration.

Bandcamp tests test_Bandcamp_2 and test_Bandcamp_3 failed with unavailable impersonation targets. test_Bandlab reported description and duration differences; test_Bandlab_1 added thumbnail differences. test_Bandlab_2 and test_Bandlab_all reported thumbnail differences. test_BandlabPlaylist_1 reported missing playlist data, and test_Bandlab_4 included HTTP 403 during a metadata request. Retained lines for test_BandlabPlaylist_3 and test_Bandlab_6 end mid-message. test_BannedVideo returned HTTP 410 Gone.

Where people get stuck: cookies, captions and changing sites

Issue #13831 reports translated-caption failures alongside working video downloads, while issue #7271 reports Chrome cookie extraction failing with the browser open. These problems affect different parts of a job. Ignoring a subtitle error lets media downloading continue; closing Chrome was the cookie reporter's successful action. Use the error and required output to choose which discussion is relevant, rather than applying every workaround to the same command.

Symptom and source What the thread reports Resolution shown in the record
Chrome cookie permission errors on Windows, issue #7271 The reporter says extraction worked after closing Chrome. Closing Chrome completely is a reported workaround. Cookie-lock record.
Translated YouTube subtitles return HTTP 429, issue #13831 DanMixerBR reports that adding -i allowed the video download to continue. Video continued while subtitle errors were ignored. Subtitle record.
SBS returns HTTP 410 after service changes, issue #16529 Commenters report downloads using a test extractor and login credentials, followed by missing subtitles and thumbnails. Media downloads resumed for commenters, with missing sidecar files. SBS record.
Crunchyroll returns HTTP 403, issue #7442 A commenter reports success with Firefox cookies and a matching User-Agent; other reports describe recurring failures. The supplied discussion contains mixed workaround outcomes. Crunchyroll record.

The SBS discussion also describes a change from combined audio/video formats to separate streams and merged MKV output. A commenter explains that best requires a combined format and suggests bv for video-only selection. That suggestion changes the requested output: video alone differs from video with audio. Read the selector alongside the files the job requires, especially when a site's available formats change. SBS format discussion.

Windows setup needs more than the downloader executable

The official release list provides a Windows 10+ standalone x64 executable, so a package manager is optional. The supplied Windows guide places yt-dlp, FFmpeg and ffprobe together and adds Deno for YouTube. FFmpeg and ffprobe handle merging and post-processing; the JavaScript runtime executes the components used for YouTube support. These tools have separate jobs even when they share one installation folder. Official release files, Windows setup guide.

The supplied Windows tutorial records an initial download at 360 by 640. Inspecting the saved file's properties exposed that result in the walkthrough. The official dependency instructions explain why FFmpeg matters when selected video and audio arrive as separate files: it merges them and supports post-processing. A setup decision should therefore include both the downloader and the helper tools required by the chosen output. Tutorial's initial resolution, official dependency instructions.

Python 3.11+ is supported by the supplied current README. Full YouTube support requires yt-dlp-ejs and a supported JavaScript runtime; Deno is recommended. The installation announcement says official executables bundle the necessary JavaScript components, while pip users should install and upgrade with the default optional dependency group. Executable users still need the runtime. Python and helper requirements, installation-specific announcement.

Batch jobs can finish with missing captions

The maintainer guidance recorded for issue #13831 recommends -i to continue video downloading after subtitle failure and -t sleep for playlists or batches. The README defines -i as ignoring download and post-processing errors, including considering a download successful after post-processing failure. DanMixerBR reports that ignoring errors allowed the video download to proceed. A caption-dependent job therefore needs a check for its subtitle output as well as its media file. Subtitle guidance and outcome, official error-handling options.

The archive option records downloaded video IDs and skips videos already listed in its file. That makes it useful for recurring collections, but the option's documented purpose is remembering downloaded videos. Define the required outputs before choosing error handling: a podcast backup might require audio and a description, while a caption-search collection also needs usable subtitle text. The Spacebar examples make those output choices concrete. Official archive option, backup and caption workflows.

What the dependency audit and licence say

Our source-harness pip-audit recorded 0 known vulnerabilities across 36 scanned packages. The installation recorded 36 dependencies and 38 MB on disk, while the repository checkout occupied 12.3 MB. These figures describe the source-harness environment and its audit result. They give a concrete record to retain alongside the installation identity when deciding how to maintain the downloader and its dependencies.

The official licensing explanation distinguishes repository code from bundled release executables. The repository, source distribution and PyPI wheel contain Unlicense code; PyInstaller executables include GPLv3+ code, making the combined work GPLv3+. The Unix zipimport executable and release tarball contain ISC and MIT components. Someone redistributing a binary inside another application should use the licensing statement for that distribution form rather than relying only on the repository's short licence label. Official distribution licensing.

yt-dlp vs youtube-dl, FFmpeg and GUI wrappers

yt-dlp is a fork of youtube-dl based on the now inactive youtube-dlc. The README documents compatibility options that revert some changed defaults, and it lists FFmpeg as required for merging separate video and audio files. A graphical wrapper changes the interface through which someone operates the downloader. These relationships make the choice clearer: migration behavior, media processing and desktop controls answer different needs. Official project and dependency documentation, GUI overview.

Candidate Why consider it Decision
youtube-dl yt-dlp is a fork, and its README documents compatibility options for some changed defaults. Inspect the documented differences when migrating an existing script. Official compatibility reference.
FFmpeg The official README requires it for merging separate video and audio and for various post-processing tasks. Use it alongside yt-dlp when the selected output needs those operations. Official FFmpeg requirements.
Stacher, yt-dlp-gui and OmniGet The supplied guide identifies them as separate graphical front ends. Choose a wrapper when buttons and menus fit the operator. GUI overview.

VideoProc's comparison author reports that yt-dlp automatically selected higher resolutions and VP9 or AV1 after using youtube-dl. Attribute that result to the author, whose page also promotes a commercial interface. For an existing script, the official documentation supplies a practical migration checklist: format behavior, compatibility options, required helper tools and the installation's update route. VideoProc format comparison, official compatibility options.

The self-hosted web-player discussion adds a server requirement to the interface decision. Ariche2 initially expected the browser extension to work alone, then discovered that it needed the server as well. The creator confirmed the requirement. Someone choosing that extension must account for a running server in addition to the browser add-on, whereas a desktop wrapper presents a different installation arrangement. Extension user and creator replies.

What the other reviews get wrong

Python 3.11+ is the supported range in the supplied official README, correcting the Python 3.7+ and 3.9+ advice identified in the research synthesis. The official release list also provides standalone Windows and macOS executables, correcting the Spacebar article's package-manager prerequisite. For installation, choose either a supported Python environment or the appropriate official executable. OSTechNix tutorial, third-party overview, official requirements and releases.

The Spacebar basic example promises MP4, while its later explanation acknowledges other containers. The supplied installation guide says output may be MP4, WebM or MKV depending on selected formats. Its explanation of FFmpeg's merging and conversion roles helps identify which helper is involved when an output must suit another application. Inspect the selected formats and saved file when the container matters to the next step. Spacebar download example, installation guide's format explanation.

The yt-dlp.dev description of FFmpeg as the one dependency worth adding leaves out yt-dlp-ejs and the JavaScript runtime required for full YouTube support. Its broad Unlicense wording also omits the executable-bundle distinction. LinuxConfig's blanket command-interchangeability advice needs the project's documented default differences beside it. The server guide attributes local success and server failure to IP reputation; the supplied YouTube discussion includes reports across multiple clean IPs. Third-party overview, LinuxConfig comparison, server guide, YouTube issue.

FAQ

Windows 10+ users can run the official standalone x64 executable without first installing a package manager. For the supplied Windows setup, put the executable in a user folder with FFmpeg and ffprobe, install Deno for YouTube, and add the folder to Path. Open a new terminal after changing Path. The questions below also cover commands, updates, cookies and interface choices. Official release files, Windows installation guide.

How do I install and run yt-dlp on Windows?

The official Windows 10+ x64 download is yt-dlp.exe in the yt-dlp releases. The supplied guide places it beside FFmpeg and ffprobe, adds the folder to Path and installs Deno for YouTube. If you open PowerShell in the executable's folder before changing Path, the guide uses .\yt-dlp.exe wherever its examples say yt-dlp. Windows installation instructions.

Where do I get the official yt-dlp.exe from GitHub?

The yt-dlp/yt-dlp repository's release assets provide the official executable. Its README calls yt-dlp.exe the recommended Windows 10+ standalone x64 binary and separately lists an ARM64 executable. Choose the asset matching the machine's architecture from the project's release page. The README lists standalone binaries alongside pip and third-party package managers as installation routes. Official download table.

How do I download a video with yt-dlp?

The supplied guide's basic command is yt-dlp "VIDEO_URL", replacing the placeholder with the video's page address and keeping the quotation marks. The official syntax accepts options followed by one or more URLs. Its --no-playlist option selects only the video when an address refers to both a video and a playlist. The resulting container depends on selected formats. Basic download instructions, official command reference.

Where can I find a list of yt-dlp commands?

The official README's "Usage and options" section lists command-line options for selection, downloading, authentication, subtitles and post-processing. The --help option prints help text, and the README groups options by task. For repeat jobs, --download-archive FILE records downloaded video IDs and skips videos already listed in the archive file. Official command and archive reference.

How do I update yt-dlp, and should I switch to nightly?

Official release binaries update with yt-dlp -U, and yt-dlp --update-to nightly switches to nightly. The supplied README recommends nightly for regular users because source-site changes can break stable releases. Its pip example is python -m pip install -U --pre "yt-dlp[default]", retaining the default extras while requesting a development release. Update through the installation route you chose. Official update instructions.

How do I pass browser cookies to yt-dlp?

The supplied overview documents --cookies-from-browser chrome, with Firefox, Edge, Brave and Safari also named. The README-task error requested browser-cookie extraction or --cookies for a cookie file. The Chrome issue reports an extraction obstacle on Windows: closing all Chrome windows allowed extraction to work for its reporter. Cookie options overview, Chrome report.

Can I copy cookies from another computer to use yt-dlp on Linux?

The supplied Crunchyroll discussion describes exporting browser cookies to a file on another computer and using that file on Linux. The maintainer warns about the file's sensitive contents and explains that different IP addresses reduce the chances of that particular workaround succeeding. The discussion concerns Crunchyroll authentication and includes reports of both successful and failed attempts. Cross-computer cookie discussion.

Why does Chrome cookie extraction fail when Chrome is open on Windows?

Issue #7271 reports that Chrome holds its cookie database open and that extraction worked after closing all Chrome windows. Closing the browser completely is the action the reporter says succeeded. The discussion also contains historical browser-flag and plugin suggestions. Start with the reported cookie-access symptom when deciding whether this thread matches the error from your command. Chrome cookie-lock discussion.

Is there a Windows GUI for yt-dlp?

Stacher, yt-dlp-gui and OmniGet are separate graphical front ends named in the supplied overview. Core yt-dlp uses the command line. A wrapper changes the controls and packaging the operator uses. The supplied existing Open Video Downloader review addresses another desktop interface; this review focuses on maintaining commands, helper tools and recurring download outputs. GUI overview.

Does a yt-dlp browser extension work without a server?

The extension discussed in the supplied self-hosted web-player thread requires its server. Ariche2 describes discovering that dependency after expecting the extension to work alone, and the creator confirms the arrangement. For this application, installation includes both the browser add-on and a running server. That server requirement belongs in the setup decision before choosing the extension as an interface. Extension and server discussion.

Should I choose yt-dlp or youtube-dl?

yt-dlp is a fork of youtube-dl with documented differences and compatibility options. For an existing script, use those differences as a migration checklist. VideoProc's author reports preferring yt-dlp's default format selection after trying both tools. For a recurring collection, yt-dlp's documented archive controls supply a specific feature to assess against the job's requirements. Official project and options, attributed comparison.

How do yt-dlp and FFmpeg differ, and do I need both?

yt-dlp finds and downloads media; FFmpeg joins separate tracks and converts audio. The official README requires FFmpeg and ffprobe for merging separate video and audio and for various post-processing tasks. It specifies the FFmpeg executable rather than the Python package with the same name. Install the helpers required by the output you choose. Media-tool roles, official dependency requirements.

What we have not tested yet

Our README task ended at authentication, and the source harness's test command failed; neither run measured a completed backup workflow. Browser-cookie extraction, successful authenticated downloads, stream merging, caption accuracy, repeat archive runs, Windows launchers, graphical wrappers and the self-hosted player remain outside our hands-on results. The documented command examples above were not executed as part of this correction. The Spacebar author's NAS automation was planned rather than completed.

The November 18 bare PyPI installation and November 14 source harness have different installation scopes, so their footprints are not competing measurements of the same environment. Both recorded the image label ghcr.io/astral-sh/uv:python3.12-bookworm; actual runtime and operating-system versions require raw toolchain logs. The retained test tail is incomplete, the parser total is not a reconciled inventory, and the authentication message alone supplies neither an IP-reputation diagnosis nor a JavaScript-runtime diagnosis.

The supplied tutorial extract supports the initial 360 by 640 resolution only. It supplies no later resolution measurement or observed improvement after adding FFmpeg. Community workaround reports and issue statuses belong to the supplied snapshots. The SBS selector advice has no successful follow-up in the extract, and the experimental extractor is not routine installation guidance. Caption availability and accuracy also constrain the usefulness of searchable subtitle files.

The evidence contains no controlled comparison of download speed or cross-tool reliability, installed-user count, representative adoption rate or support guarantee. The dependency audit does not assess cookie handling, plugins, extensions or wrapper security. Rendered layout, automatic related links and recommendation modules were also outside this text correction. A useful next evaluation is a small backup of media you control, checking the required files and then the behavior of a repeat run.

Alternatives

ProjectWhat it isPick it when
youtube-dlThe related command-line downloader from which yt-dlp was forked.Consider retaining an existing workflow that depends on its behavior; inspect yt-dlp's documented default differences before migrating.
FFmpeg gh↗Media-processing software used alongside yt-dlp for merging and conversion.Choose it to process existing media, or use it alongside yt-dlp when downloaded streams require merging or conversion.
StacherA separate graphical front end around yt-dlp named in the supplied overview.Choose a wrapper when buttons and menus fit the operator's workflow.

Sources

  1. yt-dlp official repository and README
  2. yt-dlp release 2026.10.26
  3. Spacebar backup and caption workflows
  4. YouTube JavaScript installation requirements
  5. Translated subtitle failures
  6. Chrome cookie-lock reports
  7. Windows installation guide

More automation reviews