Skip to content

Latest commit

 

History

History
264 lines (171 loc) · 9.36 KB

README_zh-tw.md

File metadata and controls

264 lines (171 loc) · 9.36 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 README 檔案的在地化部分。

主題

Windows WPF GUI 內建了淺色和深色主題，以及根據目前 Windows 主題進行即時更新的選項；它還支援使用者建立主題！更多詳情，見 WPF README 檔案的主題部分。

影片示範

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 README 檔案（暫無繁體中文）。

Linux – 開始

  1. 有些 Release，如 Linux Alpine，缺少某些語言（阿拉伯語、波斯語、泰語等）的字型。如果是這種情況，請安裝額外的字體系列，如 Noto Sans；或檢視 Release 的字型 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 README 檔案（暫無繁體中文）。

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 README 檔案（暫無繁體中文）。

從原始碼構建

要求

構建說明

  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. 及其附屬公司沒有任何關聯。