Pytube命令行工具(CLI)使用完全指南

Pytube命令行工具(CLI)使用完全指南

pytube A lightweight, dependency-free Python library (and command-line utility) for downloading YouTube Videos. 项目地址: https://gitcode.com/gh_mirrors/py/pytube

Pytube不仅是一个强大的Python库，还提供了便捷的命令行接口(CLI)，让用户无需编写代码就能直接下载在线视频和音频。本文将详细介绍Pytube CLI的各项功能和使用方法。

基础下载功能

下载最高分辨率视频

最简单的使用方式是直接提供视频URL，Pytube会自动下载最高分辨率的渐进式流媒体：

pytube https://www.example.com/watch?v=2lAe1cqCOXo

渐进式流媒体(progressive stream)是指视频和音频合并在一起的单一文件，适合大多数普通用户使用。

查看可用流媒体选项

在下载前，你可以先查看视频所有可用的流媒体格式：

pytube https://www.example.com/watch?v=2lAe1cqCOXo --list

这会显示一个表格，包含各种分辨率、格式和对应的itag编号。

按itag下载特定流媒体

从列表中获取itag后，可以指定下载特定质量的流媒体：

pytube https://www.example.com/watch?v=2lAe1cqCOXo --itag=22

itag=22通常对应720p分辨率的MP4格式视频。

字幕功能

查看可用字幕

在线视频可能提供多种语言的字幕：

pytube https://www.example.com/watch?v=2lAe1cqCOXo --list-captions

下载特定字幕

下载英文字幕(SRT格式)：

pytube https://www.example.com/watch?v=2lAe1cqCOXo -c en

SRT是最常见的字幕格式，可以被大多数播放器识别。

音频下载功能

如果只需要音频而不需要视频，可以使用音频专用选项：

pytube https://www.example.com/watch?v=2lAe1cqCOXo -a

默认会下载AAC编码的MP4格式音频，这是兼容性最好的音频格式之一。

高级功能

获取帮助信息

查看所有可用命令选项：

pytube --help

生成播放报告

在提交bug报告时，可以使用以下命令生成播放报告：

pytube https://www.example.com/watch?v=2lAe1cqCOXo --build-playback-report

这会收集必要的调试信息，帮助开发者重现问题。

使用建议

1. 对于普通用户，直接使用基础下载命令即可满足大多数需求
2. 需要特定格式或质量的用户，建议先使用--list查看可用选项
3. 下载长视频时，可以考虑只下载音频(-a)以节省带宽和存储空间
4. 如果遇到问题，先尝试生成播放报告再提交问题

Pytube CLI工具的设计简洁而强大，通过简单的命令就能完成复杂的视频下载任务，是处理在线媒体内容的利器。

pytube A lightweight, dependency-free Python library (and command-line utility) for downloading YouTube Videos. 项目地址: https://gitcode.com/gh_mirrors/py/pytube