---
id: pytube
version: "15.0.0"
license: The Unlicense (Unlicense)
license_treatment: permissive
maintenance: dormant
---

# pytube — Python 3 library for downloading YouTube Videos.

License: permissive · Maintenance: dormant · Downloads: 4.8M/mo

## What it is and what it does

pytube is a lightweight, dependency-free Python library for scripting YouTube video downloads. It exposes a simple API to fetch video metadata, select streams by quality or format, and download them to disk, plus a command-line tool for one-off downloads. The library supports both progressive (single-file) and DASH (separate audio/video) streams, playlists, captions in SubRip format, and thumbnail URLs.

The package is dormant—its last release was in May 2023 and the repository has seen no commits since August 2024. YouTube's streaming infrastructure and authentication mechanisms evolve regularly, so users should expect compatibility issues and should verify that the package still works with current YouTube before relying on it in production. The library has no external dependencies, making installation straightforward, but the lack of active maintenance means bug fixes and API adaptations are unlikely.

Use it for:

- Download a single YouTube video at a chosen quality level from a Python script for offline viewing or archival.
- Batch-download an entire YouTube playlist programmatically with custom filtering by resolution or file format.
- Extract and save video captions in SubRip (.srt) format for subtitle use or transcription workflows.
- Retrieve thumbnail images and stream metadata from YouTube videos without downloading the full video file.
- Build a command-line tool or shell script to download videos on demand without writing Python code.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pytube downloads YouTube videos and playlists to local files via Python API or command-line interface, with support for multiple stream formats and quality levels.

Yes, if you need a simple, dependency-free way to download YouTube videos and can verify it still works with current YouTube. No, if you require active maintenance, bug fixes, or assurance of compatibility—the package is dormant and YouTube's API changes frequently, so expect breakage without notice. Consider it a working tool for personal use or one-off scripts, not a production dependency.

## Install

pip install pytube
uv add pytube
poetry add pytube

## Installing pytube

Before you install: Low install friction with no runtime dependencies. Maintenance is dormant—last release was 2023-05-07 and no commits since 2024-08-15—so expect compatibility issues with YouTube's evolving API and no active bug fixes.

License in practice: Licensed under The Unlicense (Unlicense), a permissive public-domain-equivalent license that places no restrictions on use, modification, or redistribution.

Quickstart:

pip install pytube

from pytube import YouTube
yt = YouTube('https://youtu.be/2lAe1cqCOXo')
yt.streams.first().download()

# Or via CLI:
# pytube https://youtu.be/2lAe1cqCOXo

Requires Python 3.7 or later. YouTube's streaming infrastructure changes frequently; this package is dormant and may break without notice.

Verify before relying:

- Whether the package currently works with YouTube's current authentication and stream-extraction mechanisms
- Whether callback functions (on_progress, on_complete) are fully functional in version 15.0.0
- Support status for DASH stream downloads and caption extraction in current YouTube environment

## Package facts

- License: The Unlicense (Unlicense) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 4.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

youtube video downloader python, download youtube videos programmatically, youtube playlist downloader, python youtube stream extractor, cli youtube video download, youtube video quality selection, batch download youtube videos, video-download, youtube, cli-tool

[View on SkillFed](https://skillfed.io/packages/pytube) · [View on PyPI](https://pypi.org/project/pytube/)