Create a jpg file containing screenshots from a video presented in a grid.
FFmpeg must be installed and accessible via the $PATH environment variable for VSGM to run. The python wrapper ffmpeg-python is also required.
Before using ffmpeg-python, FFmpeg must be installed and accessible via the $PATH environment variable.
There are a variety of ways to install FFmpeg, such as the official download links, or using your package manager of choice (e.g. sudo apt install ffmpeg on Debian/Ubuntu, brew install ffmpeg on OS X, etc.).
Regardless of how FFmpeg is installed, you can check if your environment path is set correctly by running the ffmpeg command from the terminal, in which case the version information should appear, as in the following example (truncated for brevity):
$ ffmpeg
ffmpeg version 4.2.4-1ubuntu0.1 Copyright (c) 2000-2020 the FFmpeg developers built with gcc 9 (Ubuntu 9.3.0-10ubuntu2)
Note: The actual version information displayed here may vary from one system to another; but if a message such as ffmpeg: command not found appears instead of the version information, FFmpeg is not properly installed.
From the download page above you can select the ffmpeg essentials build, which contains the needed .exe files. Make sure they are available via the $PATH.
The latest version of ffmpeg-python can be acquired via a typical pip install:
pip install ffmpeg-python
Execute the vsgm.py file and it will ask you for a drive name, then you can select what folder to scan for video files.
python vsgm.py
The script will scan the folder you chose and its subfolders for video files, and create screenshot grids with the same name.
You can execute the script by adding the folder to scan for videos as a parameter.
python vsgm.py e:\my-videos
If you get an error dealing with UnicodeEncoding errors like:
File "C:\Python311\Lib\encodings\cp1252.py", line 19, in encode
UnicodeEncodeError: 'charmap' codec can't encode character '\u0440' in position 59: character maps to <undefined>
Run the following command in terminal to make sure you are using UTF-8 which has all of the unicode characters.
export PYTHONIOENCODING=utf-8
- Added videfilename and length in upper left corner
- Made the final image smaller if wider than 5000 px
- Added __init__py file in scripts folder
- Updated example image
- Project started
This project is licensed under the terms of the MIT License. Enjoy!
Kim Steinhaug: @steinhaug LinkedIn Website