Skip to content

Latest commit

 

History

History
264 lines (171 loc) · 9.35 KB

README_zh-cn.md

File metadata and controls

264 lines (171 loc) · 9.35 KB
Raw
Logo

Twitch Downloader

Twitch 点播 / 剪辑 / 聊天下载及聊天渲染

反馈漏洞

聊天渲染示例

example.mp4

它能做什么？

  • 下载 Twitch 点播
  • 下载 Twitch 剪辑
  • 以包含所有原始信息的 JSON、浏览器 HTML 文件或纯文本文件的形式下载点播和剪辑的聊天内容
  • 更新之前生成的 JSON 聊天文件的内容，并提供另一种格式的保存选项
  • 使用之前生成的 JSON 聊天文件，用 Twitter Twemoji 或 Google Noto Color 表情符号以及 BTTV、FFZ、7TV 静态和动画表情来呈现聊天内容

GUI

Windows 呈现基础 (WPF)

WindowsWPF

点击此处查看完整的 WPF 文档（英语）

功能介绍

Windows WPF GUI 实现了程序的所有主要功能以及一些额外的提升效率的功能：

  • 排队同时运行多个下载 / 渲染任务
  • 从点播 / 剪辑链接列表中创建下载任务列表
  • 搜索并下载来自任何流媒体的多个点播 / 剪辑，无需离开应用程序

多语言支持

通过社区翻译，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?

目前还没有适用于 MacOS 的 GUI 版本 :(

CLI

点击此处查看完整的 CLI 文档

CLI 是跨平台的，可以实现程序的主要功能。它可在 Windows、Linux 和 MacOS* 上运行。

*仅对 Intel Mac 进行了测试

通过 CLI，可以使用外部脚本自动处理视频。例如，你可以在 Windows 上将以下代码复制粘贴到 .bat 文件中，下载点播及其聊天内容，然后渲染聊天内容，所有这些都只需一次输入。

@echo off
set /p vodid="输入点播 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:\folder\containing\TwitchDownloaderCLI
  1. 如果没有 FFmpeg，可以通过 Chocolatey 软件包管理器安装，也可以从 ffmpeg.org 或使用 TwitchDownloaderCLI 以独立文件的形式获取：
TwitchDownloaderCLI.exe ffmpeg --download
  1. 你现在可以开始使用 TwitchDownloaderCLI 了，例如：
TwitchDownloaderCLI.exe videodownload --id <点播 ID> -o out.mp4

更多命令示例请参阅 CLI 自述文件。

Linux – 开始

  1. 有些发行版，如 Linux Alpine，缺少某些语言（阿拉伯语、波斯语、泰语等）的字体。如果是这种情况，请安装额外的字体系列，如 Noto Sans，或者查看发行版的字体 Wiki 页面，因为它可能有针对这种特定情况的安装命令，如 Linux Alpine 字体页面。
  2. 确保 fontconfig 和 libfontconfig1 都已安装。在 Ubuntu 上运行 apt-get install fontconfig libfontconfig1。
  3. 前往发行版页面并下载最新的 Linux 版本抓取适用于 Arch Linux 的 AUR 软件包，或从源代码构建。
  4. 提取 TwitchDownloaderCLI。
  5. 打开二进制可执行文件放置的目录：
cd directory/containing/TwitchDownloaderCLI
  1. 授予二进制可执行文件权限：
sudo chmod +x TwitchDownloaderCLI
  1. a) 如果没有 FFmpeg，可以通过 Chocolatey 软件包管理器安装，也可以从 ffmpeg.org 或使用 TwitchDownloaderCLI 以独立文件的形式获取：
./TwitchDownloaderCLI ffmpeg --download
  1. b) 如果下载的是独立文件，还必须授予其可执行权限：
sudo chmod +x ffmpeg
  1. 你现在可以开始使用 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
  1. 前往发行版页面并下载最新的 MacOS 版本或从源代码构建。
  2. 提取 TwitchDownloaderCLI。
  3. 打开二进制可执行文件放置的目录：
cd directory/containing/TwitchDownloaderCLI
  1. 授予二进制可执行文件在终端中的权限：
chmod +x TwitchDownloaderCLI
  1. a) 如果没有 FFmpeg，可以通过 Homebrew 软件包管理器在整个系统中安装，也可以从 ffmpeg.org 或使用 TwitchDownloaderCLI 以独立文件的形式获取：
./TwitchDownloaderCLI ffmpeg --download
  1. b) 如果下载的是独立文件，还必须授予其可执行权限：
chmod +x ffmpeg
  1. 你现在可以开始使用 TwitchDownloaderCLI 了，例如：
./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4

更多命令示例请参阅 CLI 自述文件。

从源代码构建

要求

构建说明

  1. 克隆此仓库：
git clone https://github.com/lay295/TwitchDownloader.git
  1. 定位至 solution 文件夹：
cd TwitchDownloader
  1. 还原 solution：
dotnet restore
  • 非 Windows 设备可能需要明确指定要还原的项目，即 dotnet restore TwitchDownloaderCLI
  1. a) 构建 GUI：
dotnet publish TwitchDownloaderWPF -p:PublishProfile=Windows
  1. b) 构建 CLI：
dotnet publish TwitchDownloaderCLI -p:PublishProfile=<Profile>
  • 可接受的配置文件：Windows、Linux、LinuxAlpine、LinuxArm、LinuxArm64、MacOS、MacOSArm64
  1. a) 定位至 GUI 构建文件夹：
cd TwitchDownloaderWPF/bin/Release/net6.0-windows/publish/win-x64
  1. b) 定位至 CLI 构建文件夹：
cd TwitchDownloaderCLI/bin/Release/net6.0/publish

第三方贡献

聊天渲染使用 SkiaSharp 和 HarfBuzzSharp © Microsoft 公司。

对聊天渲染进行编码，并最终完成视频下载使用 FFmpeg © FFmpeg 开发者。

聊天渲染可能会使用 Noto Color 表情符号 © Google 及其贡献者。

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

内置的 FFmpeg 二进制文件取自 gyan.dev © Gyan Doshi。

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

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

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

开源许可协议

MIT

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