yt-dlp 安装教程:Windows/Mac/Linux 平台 (详细指南)
yt-dlp 是一个基于 youtube-dl
的命令行工具,用于从各种在线视频平台下载视频、音频和其他媒体文件。它具有原版 youtube-dl
的所有功能,并添加了许多增强功能,例如更快的速度、更好的分段下载支持以及对更多网站的支持。本教程将详细介绍如何在 Windows、macOS 和 Linux 平台上安装 yt-dlp,并提供一些基本的使用方法。
为什么选择 yt-dlp?
在深入安装教程之前,我们先来了解一下 yt-dlp 相比于其他类似工具的优势:
- 活跃的维护: yt-dlp 项目维护积极,持续修复漏洞、添加新功能和支持新的网站。这意味着它能更好地适应不断变化的互联网环境。
- 速度: yt-dlp 优化了下载算法,通常比原版
youtube-dl
速度更快。 - 功能丰富: 除了基本的视频下载功能外,yt-dlp 还支持提取字幕、选择特定格式、合并视频和音频、下载播放列表等高级功能。
- 分段下载: yt-dlp 支持分段下载,可以提高下载速度和稳定性,尤其是在网络环境不佳的情况下。
- 广泛的平台支持: 可以在 Windows、macOS 和 Linux 等主流操作系统上运行。
- 开源和免费: yt-dlp 是一个开源项目,可以免费使用。
准备工作
在开始安装之前,请确保您满足以下条件:
- 稳定的网络连接: 下载工具和依赖项需要网络连接。
- 管理员权限 (可选): 在某些情况下,可能需要管理员权限才能安装 yt-dlp。
- 充足的磁盘空间: 下载视频需要足够的磁盘空间。
一、Windows 平台安装
在 Windows 上安装 yt-dlp 有多种方法,我们推荐使用以下两种方法:
方法一:使用 Chocolatey (推荐)
Chocolatey 是 Windows 上的一个包管理器,可以简化软件的安装过程。
- 安装 Chocolatey:
- 以管理员身份打开命令提示符 (Command Prompt) 或 PowerShell。
-
复制并粘贴以下命令到命令提示符或 PowerShell 中,然后按回车键:
powershell
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) -
等待安装完成。 安装完成后,重新打开命令提示符或 PowerShell。
-
使用 Chocolatey 安装 yt-dlp:
-
在命令提示符或 PowerShell 中输入以下命令,然后按回车键:
choco install yt-dlp
-
如果提示需要确认,输入
Y
并按回车键。 -
安装完成后,您就可以在命令提示符或 PowerShell 中使用
yt-dlp
命令了。 -
更新 yt-dlp:
-
要更新 yt-dlp 到最新版本,可以使用以下命令:
choco upgrade yt-dlp
方法二:手动安装
这种方法更复杂,但不需要依赖包管理器。
- 下载 yt-dlp 可执行文件:
- 访问 yt-dlp 的 GitHub Release 页面:https://github.com/yt-dlp/yt-dlp/releases
-
找到最新版本的 Windows 可执行文件 (
yt-dlp.exe
) 并下载。 -
安装 FFmpeg (必需):
yt-dlp 依赖 FFmpeg 进行视频和音频的合并以及格式转换。
- 访问 FFmpeg 官方网站:https://ffmpeg.org/download.html
- 选择适合您的 Windows 版本的 FFmpeg (建议下载
Static
版本)。 - 下载 FFmpeg 的压缩包,例如
ffmpeg-release-full.7z
。 - 解压该压缩包到您选择的目录,例如
C:\ffmpeg
. -
将 FFmpeg 的
bin
目录添加到系统环境变量PATH
中。 具体步骤如下:- 在 Windows 搜索栏中搜索 “环境变量”。
- 点击 “编辑系统环境变量”。
- 点击 “环境变量” 按钮。
- 在 “系统变量” 部分找到 “Path” 变量,然后点击 “编辑”。
- 点击 “新建” 按钮,然后添加 FFmpeg 的
bin
目录的路径,例如C:\ffmpeg\bin
. - 点击 “确定” 按钮保存所有更改。
-
将 yt-dlp.exe 放置到合适的位置:
将下载的 yt-dlp.exe
文件移动到一个方便使用的目录,例如 C:\Program Files\yt-dlp
。 您也可以将此目录添加到系统环境变量 PATH
中,方便在任何位置使用 yt-dlp
命令。 添加方法与添加 FFmpeg 类似。
- 测试安装:
- 打开命令提示符或 PowerShell。
- 输入
yt-dlp --version
并按回车键。 如果安装成功,将显示 yt-dlp 的版本信息。
二、macOS 平台安装
在 macOS 上安装 yt-dlp 的推荐方法是使用 Homebrew 包管理器。
- 安装 Homebrew:
- 打开终端 (Terminal)。
-
复制并粘贴以下命令到终端中,然后按回车键:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-
按照提示操作,输入您的管理员密码,并等待安装完成。
-
使用 Homebrew 安装 yt-dlp:
-
在终端中输入以下命令,然后按回车键:
brew install yt-dlp
-
等待安装完成。
-
安装 FFmpeg (必需):
-
在终端中输入以下命令,然后按回车键:
brew install ffmpeg
-
等待安装完成。
-
更新 yt-dlp:
-
要更新 yt-dlp 到最新版本,可以使用以下命令:
brew upgrade yt-dlp
三、Linux 平台安装
在 Linux 上安装 yt-dlp 的方法取决于您的发行版。 以下是几种常见的安装方法:
方法一:使用 pip (推荐)
pip 是 Python 的包管理器,可以用来安装 yt-dlp。 这种方法适用于已经安装了 Python 的用户。
- 安装 Python 和 pip (如果尚未安装):
-
在 Debian/Ubuntu 系统上,可以使用以下命令安装 Python 和 pip:
bash
sudo apt update
sudo apt install python3 python3-pip -
在 Fedora/CentOS/RHEL 系统上,可以使用以下命令安装 Python 和 pip:
bash
sudo dnf install python3 python3-pip -
不同的 Linux 发行版可能需要不同的命令,请参考您的发行版的文档。
-
使用 pip 安装 yt-dlp:
-
在终端中输入以下命令,然后按回车键:
bash
pip3 install --upgrade yt-dlp
如果您没有权限,可以使用--user
选项安装到用户目录:
bash
pip3 install --user --upgrade yt-dlp -
安装 FFmpeg (必需):
-
在 Debian/Ubuntu 系统上,可以使用以下命令安装 FFmpeg:
bash
sudo apt update
sudo apt install ffmpeg -
在 Fedora/CentOS/RHEL 系统上,可以使用以下命令安装 FFmpeg:
bash
sudo dnf install ffmpeg -
更新 yt-dlp:
-
要更新 yt-dlp 到最新版本,可以使用以下命令:
bash
pip3 install --upgrade yt-dlp
或者,如果使用了--user
选项:
bash
pip3 install --user --upgrade yt-dlp
方法二:使用包管理器 (取决于您的发行版)
某些 Linux 发行版提供了 yt-dlp 的软件包。
- Arch Linux:
bash
sudo pacman -S yt-dlp
- 其他发行版:
请参考您的发行版的软件仓库或文档,查找 yt-dlp 的安装方法。 例如,在某些发行版中,您可能需要先启用特定的软件仓库才能安装 yt-dlp。
方法三:手动安装
与 Windows 类似,您也可以手动下载 yt-dlp 的可执行文件并安装。
- 下载 yt-dlp 可执行文件:
- 访问 yt-dlp 的 GitHub Release 页面:https://github.com/yt-dlp/yt-dlp/releases
-
找到最新版本的 Linux 可执行文件 (
yt-dlp
) 并下载。 -
安装 FFmpeg (必需): 按照您发行版的说明安装 FFmpeg。
-
将 yt-dlp 放置到合适的位置:
-
将下载的
yt-dlp
文件移动到/usr/local/bin
目录,并使其可执行:bash
sudo mv yt-dlp /usr/local/bin/
sudo chmod +x /usr/local/bin/yt-dlp -
测试安装:
- 打开终端。
- 输入
yt-dlp --version
并按回车键。 如果安装成功,将显示 yt-dlp 的版本信息。
基本使用方法
安装完成后,您就可以开始使用 yt-dlp 下载视频了。
- 下载单个视频:
bash
yt-dlp [视频 URL]
例如:
bash
yt-dlp https://www.youtube.com/watch?v=dQw4w9WgXcQ
这会将视频下载到当前目录。
- 选择视频质量:
bash
yt-dlp -f bestvideo+bestaudio [视频 URL]
-f
选项用于指定视频和音频的格式。 bestvideo+bestaudio
会选择最佳的视频和音频质量。
- 下载播放列表:
bash
yt-dlp [播放列表 URL]
这会将播放列表中的所有视频下载到当前目录。
- 下载特定范围的视频:
bash
yt-dlp --playlist-start 10 --playlist-end 20 [播放列表 URL]
这会下载播放列表中第 10 到 20 个视频。
- 设置下载目录:
bash
yt-dlp -o "/path/to/download/directory/%(title)s.%(ext)s" [视频 URL]
-o
选项用于指定下载目录和文件名格式。 %(title)s
会替换为视频标题, %(ext)s
会替换为视频文件扩展名。
- 下载字幕:
bash
yt-dlp --write-subs --sub-lang en [视频 URL]
--write-subs
选项用于下载字幕, --sub-lang en
用于指定下载英文字幕。
- 显示所有可用格式:
bash
yt-dlp -F [视频 URL]
这会列出所有可供下载的格式及其 ID。 您可以使用 -f
选项和相应的 ID 来选择要下载的特定格式。
高级用法
yt-dlp 还有很多高级用法,例如:
- 配置选项: 可以创建一个配置文件来存储常用的选项,避免每次都输入相同的命令。
- 代理设置: 可以使用代理服务器进行下载。
- 自定义提取器: 可以编写自定义提取器来支持新的网站。
常见问题解答
-
Q: yt-dlp 下载速度慢怎么办?
-
A: 尝试使用分段下载选项,例如
--fragment-retries infinite
. 检查网络连接,确保网络稳定。 也可以尝试更换不同的下载服务器。 -
Q: yt-dlp 无法下载某个视频怎么办?
-
A: 确保 yt-dlp 是最新版本。 检查视频 URL 是否正确。 某些网站可能需要登录才能下载视频。 尝试使用不同的提取器。
-
Q: yt-dlp 下载的视频没有声音怎么办?
-
A: 确保 FFmpeg 已正确安装并配置。 尝试下载视频和音频分别的文件,然后使用 FFmpeg 合并它们。
结论
yt-dlp 是一个功能强大且易于使用的视频下载工具。 通过本教程,您应该能够在 Windows、macOS 和 Linux 平台上成功安装 yt-dlp,并开始下载您喜欢的视频和音频。 记住要保持 yt-dlp 和 FFmpeg 都是最新版本,以获得最佳的性能和支持。 祝您使用愉快!