Registry / type-stubs / types-yt-dlp

types-yt-dlp

JSON →
library2026.3.17.20260605pypypiunverified

Typing stubs for yt-dlp, providing type hints for the yt-dlp library. Current version 2026.3.17.20260408, released weekly by typeshed. Compatible with Python >=3.10.

type-stubs
pip install types-yt-dlp
github ↗package ↗changelog ↗
INSTALL
IMPORT
SIG · TYPES-YT-DLP
T
types-yt-dlp
type-stubspythonv2026.3.17.20260605
Install
1.8s avg
Import
—
Disk
18MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v2026.3.17.20260605 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 19.5MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 1.8s · import 0.000s · 20MB
18MB installed
● package 18MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

YoutubeDL
✓ from yt_dlp_stubs import YoutubeDL
✗ from yt_dlp import YoutubeDL

Minimal example showing typed usage of YoutubeDL.

import yt_dlp def download(url: str) -> None: ydl_opts = {'quiet': True} with yt_dlp.YoutubeDL(ydl_opts) as ydl: info = ydl.extract_info(url, download=False) print(info.get('title', 'No title')) download('https://www.youtube.com/watch?v=dQw4w9WgXcQ')
Debug
Known issues
gotchaThe stub package must be installed separately; it does not ship with yt-dlp. Forgetting to install types-yt-dlp results in missing type hints.
fix
Run 'pip install types-yt-dlp' or add it to your dev dependencies.
affects: all
deprecatedOld import patterns like 'from yt_dlp.utils import ...' may not be fully covered by stubs. Prefer top-level imports.
fix
Use 'from yt_dlp import ...' for main classes.
affects: >=2023
gotchaThe stubs are generated from typeshed and may lag behind yt-dlp releases. Newer yt-dlp features might not have type hints.
fix
Check the yt-dlp version compatibility; upgrade types-yt-dlp regularly.
affects: all
Upgrade
Version history
2026.3.17.20260605latest on PyPI · released Jun 5, 2026
Audit
Dependencies
yt-dlprequiredRuntime library for which types are provided; must be installed separately.
Agent activity
53 hits · last 30 days
node
44
OpenAI (training)
1
Resources
githubhttps://github.com/typeshed-internal/stub_uploader ↗
packagehttps://pypi.org/project/types-yt-dlp/ ↗
changeloghttps://github.com/typeshed-internal/stub_uploader/blob/main/data/changelogs/yt-dlp.md ↗
types-yt-dlp — pip install types-yt-dlp · libregistry