youtube-downloader

YouTube Downloader - 智能视频下载助手

技能概述

YouTube Downloader 是一个强大的命令行工具，帮助您下载 YouTube 视频，支持自定义质量设置（从 360p 到 1080p 及更高）、多种格式选择（MP4、WebM、MKV）以及音频-only 模式（MP3），让离线观看和内容存档变得简单高效。

适用场景

离线观看和存档

当您需要在无网络环境下观看视频，或希望永久保存重要的教育内容、演讲、音乐视频时，可以直接下载到本地存储设备，随时访问。

音频提取和音乐收藏

对于音乐视频、播客、有声读物等内容，您可以只下载音频轨道保存为 MP3，节省存储空间的同时保留高质量音频，适合音乐爱好者和播客听众。

内容创作和教学准备

教师可以下载教学视频用于课堂，内容创作者可以收集素材进行二次创作，研究人员可以存档参考资料进行深度分析。

核心功能

灵活的质量控制

支持从 360p 到 1080p 及更高分辨率的质量选择，包括 best（最佳可用）、worst（最低质量）等预设，您可以根据存储空间和网络状况自由选择，平衡画质与文件大小。

多格式支持和音频提取

除了主流的 MP4 格式，还支持 WebM 和 MKV 容器；特别提供音频-only 模式，直接将视频转换为 MP3 文件，满足不同使用场景的格式需求。

自动化安装和便捷操作

内置 yt-dlp 自动安装机制，首次使用无需手动配置依赖；提供简洁的命令行接口，通过直观的参数（-q 质量、-f 格式、-a 音频-only、-o 输出路径）即可完成复杂操作。

常见问题

如何下载 YouTube 高清视频？

使用 -q 参数指定质量，例如 python scripts/download_video.py "视频URL" -q 1080p 即可下载 Full HD 视频；如果不确定可用质量，使用 best 选项自动选择最高可用画质。

YouTube 视频可以转换成 MP3 吗？

可以，使用 -a 或 --audio-only 参数，例如 python scripts/download_video.py "视频URL" -a，工具会自动提取音频轨道并保存为 MP3 格式，无需手动转换。

支持 4K 和 1080p 质量下载吗？

支持 1080p 及更高分辨率（包括 4K，如果视频源提供）。使用 best 质量选项会自动选择可用的最高画质，也可以明确指定 1080p 或其他分辨率（720p、480p、360p）。

下载 YouTube 视频需要安装什么软件？

工具内置 yt-dlp 自动安装，首次运行时会自动处理依赖。您只需要 Python 环境，无需手动安装复杂的下载软件或浏览器插件。

可以下载 YouTube 播放列表吗？

当前版本专注于单个视频下载。如果需要批量处理播放列表，建议使用 yt-dlp 的播放列表功能，或关注后续更新。

如何选择视频质量？

使用 -q 参数后跟质量值，例如：-q best（最佳）、-q 720p、-q 480p。质量选项会根据视频源的实际可用流进行调整；如果指定质量不可用，会选择最接近的选项。

下载的视频保存在哪里？

默认保存到 /mnt/user-data/outputs/ 目录，文件名基于视频标题自动生成。您可以使用 -o 或 --output 参数指定自定义路径，例如 -o /path/to/directory。

支持哪些视频格式？

支持 MP4（默认，最兼容）、WebM（现代格式，适合 Web 应用）、MKV（Matroska 容器）。使用 -f 参数指定格式，例如 -f webm；音频下载固定为 MP3 格式。