Video Contact Sheet *NIX
- Details (and download)
- Updates / WiP
- Default behaviour
- Some samples
- Known issues
- Next version futures
- Similar tools
- Current version: 1.13.3, released on May 26th 2017. Announcement post.
NOTE: I intend to remove some features, please take a look
at this post if you have an opinion to share.
Packages: Script and extra files (sample profiles and configuration):
[deb (all arches)]
[rpm (generic, all arches)]
[Arch Linux PKGBUILD]
Debian repository: packages.outlyer.net
- Status: Stable (some bugs granted of course) on both Linux and FreeBSD.
Believed to work on other UNIX-like systems but untested.
- Released under the terms of the GNU LGPL.
- To track new releases, take a look at its Freecode page.
- Requirements (most desktops should have all, or most, of them):
ImageMagick (at least version 6.3.5-7) (convert, montage and identify commands),
FFmpeg (preferably both),
and some common stuff available on most sane desktops: bash (≥ 3.1) (for bash v2.05b use vcs 1.12.2),
sed, grep/egrep, getopt and cut.
DVD support (optional) requires lsdvd and perl.
- Slightly buggy :P
- Any contribution, suggestion or bug report is welcome.
Updates / WiP
Updates are posted at my main site, see http://outlyer.net/etiq/projects/vcs/.
This is a bash script meant to create video contact sheets (previews) of
videos. Any video supported by mplayer and ffmpeg can be used.
A note of warning:
Unlike most similar tools it, by default, makes screenshots the same size as
the video, see below for details on how to change this.
Take a look at the documentation
and/or use the --help and --fullhelp options to learn how to use it.
- Using -i or -n with values that lead to the same number of vidcaps
doesn't necessarily yield exactly the same vidcaps, you'll
have to play with them for best results.
Example: With a video that lasts for 22min 14secs, -n 6
will create the six vidcaps:
3:22, 6:44, 10:04, 13:28, 16:50 and 20:12,
while -i 3m will create
3:00, 6:00, 9:00, 12:00, 15:00 and 18:00.
As you can see, -n distributes the vidcaps all over the video
while -i N starts at N and goes in increments
of it up to the end.
- You can set the aspect ratio of the video with -a. It is only
required for anamorphic material and discouraged for the rest.
It can take either a floating point number (like 1.33 or
1.778) or a fraction (like 4/3 or 16/9).
The latter is slightly preferable.
By using configuration files and/or command line options the default behaviour
can be tweaked to your needs, this are the defaults, followed by a link with
the explanation on how to change it:
The full package includes also manpages for the script (vcs(1)) and configuration (vcs.conf(5)).
Documentation has been moved to a separate set of pages.
Samples with varied options:
More samples can be found in the documentation site, e.g. in: Samples, Example configurations, Setting colours
- Getting stuck on first frame
- This happening is a sign that the decoder (FFmpeg or MPlayer) has problems dealing with the input file. Interrupt
with CTRL+C and re-run with -O stderr=/dev/stderr to display decoder errors. It might be due to unsupported codecs or
broken files, there's little more you can do, except trying with the other decoder (-M to use MPlayer, -F to
use FFmpeg, which is the default).
- Getting gray frames
- This is a decoder error (either due to a broken file or some codec bug). Again little to be done other than switching decoders.
Remember this is a (neverending) work in progress, please report any bugs you encounter, either through e-mail or the bug tracker.
Next version features
Other similar tools available for POSIX/UNIX-like systems:
These are the changes since the last full version of some interest to end users.
Also available is a selection of changes of all versions at the wiki;
and the full changelog is in a separate file (CHANGELOG or CHANGELOG.gz).
(Contributors are listed there too.)
1.13.3 (Published May 26th 2017)
- Added codec IDs for h.265 (HEVC) and VP9
- Allow disabling coloured output to console altogether
- Bugfix to cropped codec information box with current ImageMagick
- Bugfixes to handling of failed captures and identification
- Bugfix to incorrect file size rounding
1.13.2 (Published May 18th 2014)
- Fix for sheets with MPlayer as capturer containing one extra capture
1.13.1 (Published February 26th 2014)
1.13 (Published March 8th 2013)
- Blank frame avoidance
- Automatic profile loading from configuration
- New 'compact' profile
- Bugfix: FreeBSD support restored
- Other fixes