Skip to content

Latest commit

 

History

History
264 lines (171 loc) · 9.32 KB

README_zh-cn.md

File metadata and controls

264 lines (171 loc) · 9.32 KB
Logo

Twitch Downloader

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

反馈漏洞

它能做什么？

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

聊天渲染示例

example.mp4

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/net10.0-windows/publish/win-x64
  1. b) 定位至 CLI 构建文件夹：
cd TwitchDownloaderCLI/bin/Release/net10.0/publish

第三方贡献

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

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

聊天渲染可能会使用 Noto Color Emoji © 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. 及其附属公司没有任何关联。