简介#

一款开源的命令行视频下载工具。

仓库地址：yt-dlp

安装与更新#

这里只介绍 Windows 中命令行的安装方法。

安装#

这里用最简单的方式安装 yt-dlp 与 ffmpeg 依赖。

如果没有 ffmpeg，例如在下载 B 站的内容时，视频与音频不会合并。

1
pip install yt-dlp              # 从 pip 安装
2
winget install yt-dlp.FFmpeg    # 从 winget 安装 yt-dlp 官方构建的 ffmpeg，安装好后会自动配置环境变量

更新#

1
pip install -U yt-dlp           # 更新 yt-dlp
2
winget upgrade yt-dlp.FFmpeg    # 更新 ffmpeg

快速上手#

默认以最高画质下载

1
yt-dlp https://www.bilibili.com/video/{BV号}

查看视频所有分辨率、音频信息

1
yt-dlp -F https://www.bilibili.com/video/{BV号}

会出现类似的以下内容

下载带音频的视频

1
yt-dlp -f100026 https://www.bilibili.com/video/{BV号}   # 100026 为视频的 ID

只下载音频

1
yt-dlp -f30280 https://www.bilibili.com/video/{BV号}    # 30280 为音频的 ID

下载音频转为 mp3 格式

1
yt-dlp -f30280 -x --audio-form mp3 https://www.bilibili.com/video/{BV号}    # 将音频转为 mp3

下载指定视频和音频

1
yt-dlp -f100026+30280 https://www.bilibili.com/video/{BV号}

通用命令，下载最佳 mp4 视频 + 最佳 m4a 音频，并合并为 mp4 格式

1
yt-dlp -f "bestvideo+bestaudio" --merge-output-format mp4 https://www.bilibili.com/video/{BV号}

下载更高画质（如 1080p+ ），需要添加参数 --cookies-from-browser chrome

警告

在 Windows 系统中使用该参数时，需要关闭对应浏览器，否则将无法从浏览器数据库中读取 cookies。详情见此处。

1
# 支持的浏览器：chrome、edge、firefox、safari
2
yt-dlp --cookies-from-browser chrome https://www.bilibili.com/video/{BV号}

如果不想使用浏览器，可以将 cookies 手动导出为 cookies.txt，然后使用以下命令下载

1
yt-dlp --cookies cookies.txt https://www.bilibili.com/video/{BV号}

给下载的文件自动重命名

占位符：

1
%(title)s：视频标题
2
%(id)s：视频 ID
3
%(uploader)s：上传者
4
%(resolution)s：分辨率
5
%(ext)s：扩展名

以 上传者 - 视频名称.扩展名 为例，命令如下：

1
yt-dlp -o '%(uploader)s - %(title)s.%(ext)s' https://www.bilibili.com/video/{BV号}

如果要预防非法文件名，添加 --restrict-filenames 会把空格、特殊字符替换为下划线

1
yt-dlp --restrict-filenames -o '%(uploader)s - %(title)s.%(ext)s' https://www.bilibili.com/video/{BV号}

添加 --embed-metadata 参数写入元信息（标题、简介、艺术家、发行日期等）；添加 --embed-thumbnail 参数写入缩略图
添加 --proxy http://127.0.0.1:7890 参数可设置下载代理

默认参数#

在 C:\Users\{用户名}\AppData\Roaming\yt-dlp\config.txt 中写入参数，可设为默认参数。

1
--embed-metadata
2
--embed-thumbnail
3
-o "%USERPROFILE%\Downloads\%(uploader)s - %(title)s.%(ext)s"
4
--merge-output-format mp4
5
-f "bestvideo+bestaudio"

提示

需要根据自身情况修改部分参数！

在命令行中使用时添加 --ignore-config 参数，可忽略默认参数。

yt-dlp 使用指南

简介#

安装与更新#

安装#

更新#

快速上手#

默认参数#

文章分享