python program that takes a video file and extracts screenshots at randomised intervals, producing a summary of a video in image form. randomisation gives a chance for frames between the regular interval to appear.
python 3.10+
- activate your python env
pip install -e .
this repovid-summarise
to use the program
the program will display the number of images that will actually be created and then ask for confirmation, so you can fine-tune your ranges in case it creates too much or too little
output files will be numbered and have a hash, so you can continually generate into the same output folder without overwriting
vid-summarise -h
for help
required arguments:
-v, --video
: select the video file-o, --output
: select output folder. folder will be created if does not exist-n1, --min
: select the minimum number of images you would like to create. due to randomisation, it will be above this value depending on your maximum chosen value-n2, --max
: select maximum number of images you would like to create. due to the interval division algorithm, it is difficult to reach this max value, but it will increase the actual number of images generated. a larger range from your minimum value will increase randomness
optional
-s, --shuffle
: shuffle the generation order, resulting in shuffled output images (images in the output do not appear in chronological order of the video)
example
vid-summarise.exe -v test.webm -o output2 -n1 100 -n2 200 -s