types-yt-dlp

What it is and what it does

This package provides type stubs—skeletal type annotations without runtime code—for yt-dlp, a popular video downloader. When installed, it allows static type checkers like mypy and pyright to understand the types and signatures of yt-dlp's public API, catching type errors in your code before runtime.

Type stubs are useful when you want type-checking benefits without modifying the original package or when the original package lacks inline annotations. This stub package is maintained as part of the typeshed project, a centralized repository of type information for the Python ecosystem. It has no runtime dependencies and is tested against multiple type checkers to ensure accuracy.

Use it for:

• Enable type checkers to validate code that calls yt-dlp functions and classes
• Catch type mismatches in yt-dlp API calls during development rather than at runtime
• Use yt-dlp in a codebase with strict type-checking enabled in CI pipelines
• Get IDE autocomplete and type hints when using a type-aware editor with yt-dlp

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type hints for yt-dlp, enabling static type checkers to validate code that uses yt-dlp without requiring the full package to be installed.

Yes, if you use yt-dlp and run static type checking. Install it alongside yt-dlp to get type safety with no runtime overhead. The package is actively maintained, has no external dependencies, and is tested against current type checkers. If you don't use type checking, there is no benefit to installing it.

Install

types-yt-dlp on PyPI

pip install types-yt-dlp

uv add types-yt-dlp

poetry add types-yt-dlp

Installing types-yt-dlp

Before you install

Low friction to install; actively maintained with releases tracking yt-dlp versions closely. Tested against current type checkers (mypy 2.3.0, pyright 1.1.411, ty 0.0.59).

License in practice

Licensed under Apache-2.0 (permissive), allowing use in most projects without significant restrictions.

Quickstart

pip install types-yt-dlp

# Type checkers will now understand types-yt-dlp annotations
# when checking code that imports yt-dlp

Requires Python 3.10 or later. Stubs are designed for yt-dlp==2026.7.4; version mismatches may cause type checker warnings.

Verify before relying

• Whether these stubs remain accurate across minor yt-dlp patch versions outside 2026.7.4
• Coverage completeness: whether all public yt-dlp APIs are annotated or only a subset
• Whether yt-dlp must be installed separately for the stubs to be useful

Package facts

Evidence: types_yt_dlp-2026.7.4.20260807-py3-none-any.whl

Tags

More Software Development packages