Twitch VOD/Clip/Chat Downloader and Chat Renderer
Report Bug
example.mp4
- Download Twitch VODs
- Download Twitch Clips
- Download chat for VODS and Clips, in either a JSON with all the original information, a browser HTML file, or a plain text file
- Update the contents of a previously generated JSON chat file with an option to save as another format
- Use a previously generated JSON chat file to render the chat with FFZ, BTTV and 7TV support (including GIFS)
The Windows GUI implements all of the main functions of the program along with some extra quality of life functions:
- Queue up multiple download/render jobs to run simultaneously
- Create a list of download jobs from a list of vod/clip links
- Search for and download multiple vods/clips from any streamer without leaving the app
The Windows GUI comes with a light and dark theme and will update according the current Windows theme by default. The GUI also supports user created themes! See Themes/README.txt
(generated on every run) for more details.
https://www.youtube.com/watch?v=0W3MhfhnYjk (older version, same concept)
Check twitch-downloader-gui on github or on the AUR for a Linux GUI wrapper for the CLI.
No GUI is available for MacOS yet :(
The CLI is cross-platform and implements the main functions of the program. It works on Windows, Linux, and MacOS*.
*Only Intel Macs have been tested
With the CLI, it is possible to automate video processing using external scripts. For example, you could copy-paste the following code into a .bat
file on Windows to download a VOD and its chat, and then render the chat, all from a single input.
@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
- Go to Releases and download the latest version for Windows or build from source.
- Extract
TwitchDownloaderCLI.exe
. - Browse to where you extracted the file in the terminal.
- If you do not have ffmpeg, you can install it via Chocolatey package manager, or you can get it as a standalone file from ffmpeg.org or by using TwitchDownloaderCLI:
TwitchDownloaderCLI.exe ffmpeg --download
- You can now start using the downloader, for example:
TwitchDownloaderCLI.exe videodownload --id <vod-id-here> -o out.mp4
- Some distros, like Linux Alpine, lack fonts for some languages (Arabic, Persian, Thai, etc.) If this is the case for you, install additional fonts families such as Noto or check your distro's wiki page on fonts as it may have an install command for this specific scenario, such as the Linux Alpine font page.
- Ensure both
fontconfig
andlibfontconfig1
are installed.apt-get install fontconfig libfontconfig1
on Ubuntu. - Go to Releases and download the latest binary for Linux, grab the AUR Package for Arch Linux, or build from source.
- Extract
TwitchDownloaderCLI
. - Browse to where you extracted the file and give it executable rights in the terminal:
sudo chmod +x TwitchDownloaderCLI
- a) If you do not have ffmpeg, you should install it via your distro package manager, however you can also get it as a standalone file from ffmpeg.org or by using TwitchDownloaderCLI:
./TwitchDownloaderCLI ffmpeg --download
- b) If downloaded as a standalone file, you must also give it executable rights with:
sudo chmod +x ffmpeg
- You can now start using the downloader, for example:
./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4
- Go to Releases and download the latest binary for MacOS or build from source.
- Extract
TwitchDownloaderCLI
. - Browse to where you extracted the file and give it executable rights in the terminal:
chmod +x TwitchDownloaderCLI
- a) If you do not have ffmpeg, you can install it via Homebrew package manager, or you can get it as a standalone file from ffmpeg.org or by using TwitchDownloaderCLI:
./TwitchDownloaderCLI ffmpeg --download
- b) If downloaded as a standalone file, you must also give it executable rights with:
chmod +x ffmpeg
- You can now start using the downloader, for example:
./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4
- Clone the repository:
git clone https://github.com/lay295/TwitchDownloader.git
- Navigate to the solution folder:
cd TwitchDownloader
- Restore the solution:
dotnet restore
- a) Build the GUI:
dotnet publish TwitchDownloaderWPF -p:PublishProfile=Windows -p:DebugType=None -p:DebugSymbols=false
- b) Build the CLI:
dotnet publish TwitchDownloaderCLI -p:PublishProfile=<Profile> -p:DebugType=None -p:DebugSymbols=false
- Applicable Profiles:
Windows
,Linux
,LinuxAlpine
,LinuxArm
,MacOS
- a) Navigate to the GUI build folder:
cd TwitchDownloaderWPF/bin/Release/net6.0-windows/publish/win-x64
- b) Navigate to the CLI build folder:
cd TwitchDownloaderCLI/bin/Release/net6.0/publish