---
id: types-yt-dlp
version: "2026.7.4.20260807"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-yt-dlp — Typing stubs for yt-dlp

License: permissive · Maintenance: active · Downloads: 73.5K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs yt-dlp, typing annotations yt-dlp, mypy type stubs, static type checking video download, pyright type hints, typeshed stubs, python type annotations, type-stubs, static-analysis

[View on SkillFed](https://skillfed.io/packages/types-yt-dlp) · [View on PyPI](https://pypi.org/project/types-yt-dlp/)