{"id":24776,"library":"types-yt-dlp","title":"types-yt-dlp","description":"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.","status":"active","version":"2026.3.17.20260408","language":"python","source_language":"en","source_url":"https://github.com/python/typeshed","tags":["typing","stubs","yt-dlp","type-hints"],"install":[{"cmd":"pip install types-yt-dlp","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Runtime library for which types are provided; must be installed separately.","package":"yt-dlp","optional":false}],"imports":[{"wrong":"from yt_dlp import YoutubeDL","symbol":"YoutubeDL","correct":"from yt_dlp_stubs import YoutubeDL"}],"quickstart":{"code":"import yt_dlp\n\ndef download(url: str) -> None:\n    ydl_opts = {'quiet': True}\n    with yt_dlp.YoutubeDL(ydl_opts) as ydl:\n        info = ydl.extract_info(url, download=False)\n        print(info.get('title', 'No title'))\n\ndownload('https://www.youtube.com/watch?v=dQw4w9WgXcQ')\n","lang":"python","description":"Minimal example showing typed usage of YoutubeDL."},"warnings":[{"fix":"Run 'pip install types-yt-dlp' or add it to your dev dependencies.","message":"The stub package must be installed separately; it does not ship with yt-dlp. Forgetting to install types-yt-dlp results in missing type hints.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'from yt_dlp import ...' for main classes.","message":"Old import patterns like 'from yt_dlp.utils import ...' may not be fully covered by stubs. Prefer top-level imports.","severity":"deprecated","affected_versions":">=2023"},{"fix":"Check the yt-dlp version compatibility; upgrade types-yt-dlp regularly.","message":"The stubs are generated from typeshed and may lag behind yt-dlp releases. Newer yt-dlp features might not have type hints.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2026.3.17.20260408':22 '3.10':30 'compat':27 'current':20 'dlp':4,10,18,35 'hint':13,38 'librari':19 'provid':11 'python':29 'releas':23 'stub':6,32 'type':2,5,12,31,37 'type-hint':36 'types-yt-dlp':1 'typesh':26 'version':21 'week':24 'yt':3,9,17,34 'yt-dlp':8,16,33","created_at":"2026-05-01T08:14:51.508704+00:00","updated_at":"2026-05-01T08:14:51.508704+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nModuleNotFoundError: No module named 'yt_dlp_stubs'"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2026.3.17.20260605","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/typeshed-internal/stub_uploader","docs":null,"changelog":"https://github.com/typeshed-internal/stub_uploader/blob/main/data/changelogs/yt-dlp.md","pypi":"https://pypi.org/project/types-yt-dlp/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["type-stubs"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}