|
1 | 1 |
|
2 |
| -### TwitchDownloader |
3 |
| -A Twitch VOD/Clip/Chat downloader I wrote, as well as a chat render feature. |
| 2 | +# TwitchDownloader |
| 3 | +Twitch VOD/Clip/Chat downloader and chat renderer I wrote. |
4 | 4 |
|
5 | 5 | **THIS USES UNDOCUMENTED API ENDPOINTS, MAY BREAK EASILY. I'LL TRY AND UPDATE WHEN IT DOES.**
|
6 |
| - |
7 | 6 |
|
8 |
| -## Chat render example |
| 7 | +## Chat Render Example |
9 | 8 | 
|
10 | 9 |
|
11 |
| -## Video Demonstration (older version, same concept) |
12 |
| -https://www.youtube.com/watch?v=0W3MhfhnYjk |
13 |
| - |
14 |
| -## What can this do? |
15 |
| -- Can download Twitch VODs |
16 |
| -- Can download Twitch Clips |
17 |
| -- Can download chat for VODS and Clips, in either a [JSON with all the information](https://pastebin.com/raw/YDgRe6X4) or a [simple text file](https://pastebin.com/raw/016azeQX) |
18 |
| -- Can use a previously generated JSON chat file, to render the chat with FFZ and BTTV support (including GIFS) |
| 10 | +## What can it do? |
| 11 | +- Download Twitch VODs |
| 12 | +- Download Twitch Clips |
| 13 | +- Download chat for VODS and Clips, in either a [JSON with all the information](https://pastebin.com/raw/YDgRe6X4) or a [simple text file](https://pastebin.com/raw/016azeQX) |
| 14 | +- Use a previously generated JSON chat file to render the chat with FFZ and BTTV support (including GIFS) |
19 | 15 |
|
20 |
| -## Things still needed to be done |
| 16 | +## Things still to be done |
21 | 17 | - Fix bugs that slipped by
|
22 | 18 | - More options for chat rendering
|
23 | 19 |
|
| 20 | +# GUI |
| 21 | + |
| 22 | + |
| 23 | + |
| 24 | +## Video Demonstration |
| 25 | +https://www.youtube.com/watch?v=0W3MhfhnYjk |
| 26 | +(older version, same concept) |
| 27 | + |
24 | 28 | ## Linux? MacOS?
|
25 |
| -Sorry the GUI version is only avaliable for Windows :( but there is a command line version avaliable. |
26 |
| -This is a cross platform client that can do the main functions of the program without a GUI. It works on Windows and Linux, haven't tested it on MacOS though. |
| 29 | +Sorry, the GUI version is only avaliable for Windows :( |
| 30 | + |
| 31 | +# CLI |
| 32 | + |
| 33 | +The CLI is cross platform and performs the main functions of the program. It works on Windows and Linux, but has not been tested on MacOS. |
27 | 34 |
|
28 |
| -[Some documentation here](https://github.com/lay295/TwitchDownloader/blob/master/TwitchDownloaderCLI/README.md), for example, you could copy/paste this into a .bat file on Windows and you can download a VOD, download chat, then render it in a single go. I've never really made a command line utility before, so things may change in the future. If you're on Linux, make sure fontconfig and libfontconfig1 are installed. (apt-get install fontconfig libfontconfig1) |
| 35 | +[Documentation here](https://github.com/lay295/TwitchDownloader/blob/master/TwitchDownloaderCLI/README.md). |
| 36 | + |
| 37 | +I've never really made a command line utility before so things may change in the future. If you're on Linux, make sure `fontconfig` and `libfontconfig1` are installed `(apt-get install fontconfig libfontconfig1)`. |
| 38 | + |
| 39 | +For example, you could copy/paste this into a `.bat` file on Windows, to download a VOD, chat, and then render in a single go. |
29 | 40 | ```
|
30 | 41 | @echo off
|
31 | 42 | set /p vodid="Enter VOD ID: "
|
32 | 43 | TwitchDownloaderCLI -m VideoDownload --id %vodid% --ffmpeg-path "ffmpeg.exe" -o %vodid%.mp4
|
33 | 44 | TwitchDownloaderCLI -m ChatDownload --id %vodid% -o %vodid%_chat.json
|
34 | 45 | TwitchDownloaderCLI -m ChatRender -i %vodid%_chat.json -h 1080 -w 422 --framerate 30 --update-rate 0 --font-size 18 -o %vodid%_chat.mp4
|
35 | 46 | ```
|
36 |
| -======= |
37 |
| - |
38 |
| -### Linux - Getting started |
| 47 | +--- |
| 48 | +### Linux – Getting started |
39 | 49 |
|
40 |
| -1. Go to releases and download the latest version for Linux |
41 |
| -2. Extract the `TwitchDownloaderCLI` |
42 |
| -3. Browse to where you extracted the file and give it executable rights by opening a terminal and executing the following: |
| 50 | +1. Go to [Releases](https://github.com/lay295/TwitchDownloader/releases/) and download the latest version for Linux. |
| 51 | +2. Extract `TwitchDownloaderCLI` |
| 52 | +3. Browse to where you extracted the file and give it executable rights in Terminal: |
43 | 53 | ```
|
44 | 54 | sudo chmod +x TwitchDownloaderCLI
|
45 | 55 | ```
|
|
0 commit comments