TwitchDownloader

抽搐下载器

Twitch VOD/剪辑/聊天下载器和聊天渲染器

报告错误

该文档还可以在以下版本中找到：

• 意大利语/意大利语
• 日语 / 日本语
• 葡萄牙语（巴西）/Português（巴西）
• 俄语 / Русский
• 西班牙语/西班牙语
• 土耳其语/Türkçe
• 简体中文/简体中文（中国大陆）
• 繁体中文/繁体中文（台湾）

聊天渲染示例

示例.mp4

它能做什么？

• 下载 Twitch VOD
• 下载 Twitch 剪辑
• 下载 VOD 和 Clips 的聊天内容，格式为包含所有原始信息的 JSON、浏览器 HTML 文件或纯文本文件
• 使用另存为其他格式的选项更新先前生成的 JSON 聊天文件的内容
• 使用之前生成的 JSON 聊天文件来渲染 Twitter Twemoji 或 Google Noto Color 表情符号以及 BTTV、FFZ、7TV 静态和动画表情的聊天

图形用户界面

Windows WPF

请在此处查看完整的 WPF 文档

功能性

Windows WPF GUI 实现了程序的所有主要功能以及一些额外的生活质量功能：

• 将多个下载/渲染作业排队以同时运行
• 从点播/剪辑链接列表创建下载作业列表
• 无需离开应用程序即可从任何流媒体搜索并下载多个 VOD/剪辑

多语言支持

由于社区翻译，Windows WPF GUI 提供多种语言版本。有关更多详细信息，请参阅 WPF 自述文件的本地化部分。

主题化

Windows WPF GUI 捆绑了浅色和深色主题，以及根据当前 Windows 主题进行实时更新的选项。它还支持用户创建的主题！有关更多详细信息，请参阅 WPF 自述文件的主题部分。

视频演示

https://www.youtube.com/watch?v=0W3MhfhnYjk（旧版本，相同概念）

Linux？

检查 github 上的 twitch-downloader-gui 或 AUR 上的 CLI 的 Linux GUI 包装器。

苹果系统？

尚无适用于 MacOS 的 GUI :(

命令行界面

请参阅此处的完整 CLI 文档

CLI是跨平台的，实现了程序的主要功能。它适用于 Windows、Linux 和 MacOS ^* 。

^{*仅 Intel Mac 电脑经过测试}

通过 CLI，可以使用外部脚本自动进行视频处理。例如，您可以将以下代码复制粘贴到 Windows 上的.bat文件中，以下载 VOD 及其聊天内容，然后呈现聊天内容，所有这些都通过单个输入完成。

 @ echo off
set /p vodid = " Enter VOD ID: "
TwitchDownloaderCLI.exe videodownload --id %vodid% --ffmpeg-path " ffmpeg.exe " -o %vodid% .mp4
TwitchDownloaderCLI.exe chatdownload --id %vodid% -o %vodid% _chat.json -E
TwitchDownloaderCLI.exe chatrender -i %vodid% _chat.json -h 1080 -w 422 --framerate 30 --update-rate 0 --font-size 18 -o %vodid% _chat.mp4

Windows - 入门

1. 转到发行版并下载适用于 Windows 的最新版本或从源代码构建。
2. 提取TwitchDownloaderCLI.exe 。
3. 浏览到提取可执行文件的位置：

 cd C:foldercontainingTwitchDownloaderCLI

4. 如果您没有 FFmpeg，您可以通过 Chocolatey 包管理器安装它，也可以从 ffmpeg.org 或使用 TwitchDownloaderCLI 将其作为独立文件获取：

 TwitchDownloaderCLI.exe ffmpeg --download

5. 您现在可以开始使用 TwitchDownloaderCLI，例如：

 TwitchDownloaderCLI.exe videodownload --id <vod-id-here> -o out.mp4

您可以在 CLI 自述文件中找到更多示例命令。

Linux – 入门

1. 某些发行版（例如 Linux Alpine）缺乏某些语言的字体（阿拉伯语、波斯语、泰语等）。如果您遇到这种情况，请安装其他字体系列，例如 Noto 或检查您发行版的 wiki 页面上的字体，因为它可能有针对此特定场景的安装命令，例如 Linux Alpine 字体页面。
2. 确保fontconfig和libfontconfig1均已安装。 apt-get install fontconfig libfontconfig1 。
3. 转到发行版并下载适用于 Linux 的最新二进制文件，获取适用于 Arch Linux 的 AUR 包，或从源代码构建。
4. 提取TwitchDownloaderCLI 。
5. 浏览到提取二进制文件的位置：

 cd directory/containing/TwitchDownloaderCLI

6. 赋予二进制可执行权限：

 sudo chmod +x TwitchDownloaderCLI

7. a) 如果您没有 FFmpeg，则应通过发行版包管理器在系统范围内安装它，但是您也可以从 ffmpeg.org 或使用 TwitchDownloaderCLI 将其作为独立文件获取：

 ./TwitchDownloaderCLI ffmpeg --download

7. b) 如果作为独立文件下载，您还必须为其授予可执行权限：

 sudo chmod +x ffmpeg

8. 您现在可以开始使用 TwitchDownloaderCLI，例如：

 ./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4

您可以在 CLI 自述文件中找到更多示例命令。

MacOS – 入门

1. 如果您的设备具有 Apple Silicon M 系列处理器，请确保下载 arm64 二进制文件，但是如果您想在 Apple Silicon 上使用 x64 二进制文件，则必须通过在 Rosetta 2 下运行的终端会话来运行它：

 arch -x86_64 zsh

2. 转到发布并下载适用于 MacOS 的最新二进制文件或从源代码构建。
3. 提取TwitchDownloaderCLI 。
4. 浏览到提取二进制文件的位置：

 cd directory/containing/TwitchDownloaderCLI

5. 在终端中赋予二进制可执行权限：

 chmod +x TwitchDownloaderCLI

6. a) 如果您没有 FFmpeg，您可以通过 Homebrew 包管理器在系统范围内安装它，或者您可以从 ffmpeg.org 或使用 TwitchDownloaderCLI 将其作为独立文件获取：

 ./TwitchDownloaderCLI ffmpeg --download

6. b) 如果作为独立文件下载，您还必须为其授予可执行权限：

 chmod +x ffmpeg

7. 您现在可以开始使用 TwitchDownloaderCLI，例如：

 ./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4

您可以在 CLI 自述文件中找到更多示例命令。

从源头构建

要求

• .NET 6.0.x SDK
• 约1GB磁盘空间

构建说明

1. 克隆存储库：

 git clone https://github.com/lay295/TwitchDownloader.git

2. 导航到解决方案文件夹：

 cd TwitchDownloader

3. 恢复解决方案：

 dotnet restore

• 非Windows设备可能需要显式指定要恢复的项目，即dotnet restore TwitchDownloaderCLI

4. a) 构建 GUI：

 dotnet publish TwitchDownloaderWPF -p:PublishProfile=Windows

4. b) 构建 CLI：

 dotnet publish TwitchDownloaderCLI -p:PublishProfile=<Profile>

• 适用的配置文件： Windows 、 Linux 、 LinuxAlpine 、 LinuxArm 、 LinuxArm64 、 MacOS 、 MacOSArm64

5. a) 导航到 GUI 构建文件夹：

 cd TwitchDownloaderWPF/bin/Release/net6.0-windows/publish/win-x64

5. b) 导航到 CLI 构建文件夹：

 cd TwitchDownloaderCLI/bin/Release/net6.0/publish

第三方积分

聊天渲染使用 SkiaSharp 和 HarfBuzzSharp © Microsoft Corporation 进行渲染。

聊天渲染经过编码，视频下载由 FFmpeg © FFmpeg 开发人员完成。

聊天渲染可能会使用 Noto Color Emoji © Google 和贡献者。

聊天渲染可能会使用 Twemoji © Twitter 和贡献者。

捆绑的 FFmpeg 二进制文件从 gyan.dev © Gyan Doshi 获取。

运行时获取的 FFmpeg 二进制文件是使用 Xabe.FFmpeg.Downloader © Xabe 下载的。

聊天 Html 导出使用由 Google Fonts API © Google 托管的Inter字体。

有关所使用的外部库的完整列表，请参阅 THIRD-PARTY-LICENSES.txt。

执照

麻省理工学院

TwitchDownloader 与 Twitch Interactive, Inc. 或其附属公司没有任何关系。