Skip to content

Latest commit

 

History

History
264 lines (171 loc) · 9.39 KB

README_zh-tw.md

File metadata and controls

264 lines (171 loc) · 9.39 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. 前往 Release 頁面 並下載最新的 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. 前往 Release 頁面 並下載最新的 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. 前往 Release 頁面 並下載最新的 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. 及其附屬公司沒有任何關聯。