High

yt-dlp on Windows vulnerable to `--exec` command injection when using `%q`

  • Disclosed: 25.09.2023
  • Updated: 11.10.2026 13:18

Impact

yt-dlp allows the user to provide shell commands to be executed at various stages in its download process through the --exec flag. This flag allows output template expansion in its argument, so that video metadata values may be used in the shell commands. The metadata fields can be combined with the %q conversion, which is intended to quote/escape these values so they can be safely passed to the shell.

However, the escaping used for cmd (the shell used by Python's subprocess on Windows) did not properly escape special characters, which can allow for remote code execution if --exec is used directly with maliciously crafted remote data. This vulnerability only impacts yt-dlp on Windows, and the vulnerability is present regardless of whether yt-dlp is run from cmd or from PowerShell.

Support for output template expansion in --exec, along with this vulnerable behavior, was added to yt-dlp in version 2021.04.11.

bash
> yt-dlp https://youtu.be/Jo66yyCpHcQ --exec "echo %(title)q"
[youtube] Extracting URL: https://youtu.be/Jo66yyCpHcQ
[youtube] Jo66yyCpHcQ: Downloading webpage
[youtube] Jo66yyCpHcQ: Downloading ios player API JSON
[youtube] Jo66yyCpHcQ: Downloading android player API JSON
[youtube] Jo66yyCpHcQ: Downloading m3u8 information
[info] Jo66yyCpHcQ: Downloading 1 format(s): 135+251
[download] Destination: "&echo(&echo(pwned&rem( [Jo66yyCpHcQ].f135.mp4
[download] 100% of    4.85KiB in 00:00:00 at 60.20KiB/s
[download] Destination: "&echo(&echo(pwned&rem( [Jo66yyCpHcQ].f251.webm
[download] 100% of    4.80KiB in 00:00:00 at 31.58KiB/s
[Merger] Merging formats into ""&echo(&echo(pwned&rem( [Jo66yyCpHcQ].mkv"
Deleting original file "&echo(&echo(pwned&rem( [Jo66yyCpHcQ].f135.mp4 (pass -k to keep)
Deleting original file "&echo(&echo(pwned&rem( [Jo66yyCpHcQ].f251.webm (pass -k to keep)
[Exec] Executing command: echo "\"&echo(&echo(pwned&rem("
"\"

pwned

Patches

yt-dlp version 2023.09.24 fixes this issue by properly escaping each special character. \n will be replaced by \r, as no way of escaping it has been found.

Workarounds

It is recommended to upgrade yt-dlp to version 2023.09.24 as soon as possible. Also, always be careful when using --exec, because while this specific vulnerability has been patched, using unvalidated input in shell commands is inherently dangerous.

For Windows users who are not able to upgrade:

  • Avoid using any output template expansion in --exec other than {} (filepath).
  • If expansion in --exec is needed, verify the fields you are using do not contain ", | or &.
  • Instead of using --exec, write the info json and load the fields from it instead.

References

Affected software

Click a technology to see all vulnerabilities affecting it.

PlatformPackageVulnerable versionsFixed in
Python (PyPI) yt-dlp >= 2021.04.11, < 2023.09.24 2023.09.24

References

CVSS score 8.3/10
CVSS vector
CVSS:3.1/AV:N/AC:H/PR:N/UI:R/S:C/C:H/I:H/A:H
Weakness (CWE)
CWE-78
Platform
Python (PyPI)
Package
yt-dlp
Disclosed
25.09.2023
Updated
11.10.2026 13:18

Sources and licenses

OSV / GitHub Advisory Database - PYSEC-2026-2064 - PyPA Advisory Database; CC BY 4.0

OSV / GitHub Advisory Database - GHSA-42h4-v29r-42qg - CC BY 4.0

Vulnerability history: yt-dlp

All published vulnerabilities of this package (Python (PyPI)), newest first. Shows whether this is a one-off slip or a package that needs watching.

All (12) in the archive
Total entries
12
First → latest
07.2023 07.2026
Without a fix
0
Exploited in attacks
0

Severity breakdown

  • High 8
  • Medium 3
  • Low 1

Disclosures per year

  1. 2023: 3
  2. 2024: 3
  3. 2025: 0
  4. 2026: 6
Severity:
  1. High · 7.5 ghsa-69qj-pvh9-c5wg >= 2021.4.11, < 2026.6.9 2026.6.9
  2. High · 8.3 CVE-2026-50574 < 2026.6.9 2026.6.9
  3. High · 8.8 CVE-2026-26331 >= 2023.06.21, < 2026.02.21 2026.02.21
  4. High · 8.3 CVE-2024-22423 >= 2021.04.11, < 2024.04.09 2024.04.09
  5. yt-dlp on Windows vulnerable to `--exec` command injection when using `%q` this entry
    High · 8.3 CVE-2023-40581 >= 2021.04.11, < 2023.09.24 2023.09.24

Know which vulnerabilities affect your application

With the DockRay integration and software inventory enabled, DockRay checks reported component versions against known vulnerabilities and notifies you about confirmed matches. Coverage depends on the supported technology and available advisory data.

Connect your application
DockRay newsletter

Application security in your inbox

Important vulnerabilities, actionable guidance and practical advice for your applications. Choose your technologies and follow what matters to your project.

  • A daily digest of new vulnerabilities, critical ones included.
  • Notifications about important updates.
  • Practical advice on application security and monitoring.

Leave empty to receive updates for every technology.

Free to subscribe. Unsubscribe with one click in any email.