Twitch VOD highlights generator
is a Twitch VOD highlights generator that downloads the best moments of pasts streams. It also has options for downloading specific parts or the entire VOD.
How it works
twigen analizes chat data and selects the segments of the stream that had more messages per sample (by default, a sample is 60 seconds). Additionally, you can specify segments of the stream that you want to be included.
About the GUI
twigen uses a command-line interface. However, if it is called without arguments a (very simple) GUI will spawn. It is a command builder, that is, the options you choose in the GUI will be translated to a command that will run on a terminal (command prompt). Technically, a terminal is not needed for it to succeed, but the GUI closes when you press the OK button and you won't be able to see the progress or if some error happens.
This command will download the highlights of https://www.twitch.tv/videos/436057160 generating a 5 minutes (at least) video:
twigen --urls 436057160 --min 5
For small channels with small chat interaction, it can be useful to use --signal and --include:
twigen --urls 436176289 --min 10 --signal --include "0:0:0, 0:1:0"
this command will look for messages in chat that contain !twigen and include that moment in the highlights. --include "0:0:0, 0:1:0" guarantees that the first minute is included in the highlights. The include option accepts multiple intervals of time:
--include "0:0:0, 0:1:0; 0:20:0, 1:0:0"
It is also possible to generate highlights using multiple VODs:
twigen --urls 436176289,437203732,438054911 --min 15 --group --output twigen_highlights.mp4
List of options
-h, --help show this help message and exit -u URLS, --urls URLS URLs or IDs of the VODs to process -q, --quiet do not print what is being done -s SAMPLE, --sample SAMPLE duration of each sample in seconds, default=60 -d DELAY, --delay DELAY start recording DELAY seconds early in each sample, default=30 -g, --group process a list of urls into a single output file -l, --check print how long the output file would be with this options -T, --tmp do not save dowloaded data to current directory -M, --muted include muted portions of the VOD -i INCLUDE, --include INCLUDE include the specified samples -Z, --signal look for !twigen in chat messages and create a sample of that moment -o OUTPUT, --output OUTPUT name of the output file -S, --segs do not concatenate samples -C, --nochat do not download chat data, process included samples only -m MIN, --min MIN minimum length of the output file when generating highlights -y HYPE, --hype HYPE float number between [0,1] used by the highlights generator for selecting samples, default=0.6
How to install
First, you need Python 3.7. On Linux, you should find it in your distro's packages. On Windows, download from the official web site.
Now, on your terminal/command prompt:
pip install twigen
or you might need to run:
python3.7 -m pip install twigen
Now you need to install ffmpeg. On Linux, your distro should have a package for it, something like:
sudo apt install ffmpeg
On Windows, download from the official web site.
Extract the .zip, rename the file to something like
FFmpeg and paste it in
Then open the command prompt and run:
setx PATH "C:\FFmpeg\ffmpeg-20190610-80e68ce-win64-static\bin;%PATH%"
so that ffmpeg can be called from the command prompt. Make sure that the folder inside ffmpeg has the name
ffmpeg-20190610-80e68ce-win64-static, if not just modify the command with the name you have.
you should see the help message from twigen.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size twigen-0.6-py3-none-any.whl (12.5 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size twigen-0.6.tar.gz (11.7 kB)||File type Source||Python version None||Upload date||Hashes View hashes|