I use gframecatcher to generate thumbnail video galleries, i.e. something like this:

enter image description here

However this is a GUI tool and I want to create recursively a gallery for every video in a directory structure, so I am looking for a fast command line tool to do this.


Pull out the image captures (these are 100 pixels tall, and keep aspect ratio), the rate (-r) is per-second (this yields one frame every ~5 minutes), this also adds time stamp to output image.

ffmpeg  -i MOVIE.mp4 -r 0.0033 -vf scale=-1:120 -vcodec png capture-%002d.png

Then use ImageMagick to build your gallery image:

montage -title "Movie Name\nSubtitle" -geometry +4+4 capture*.png output.png
  • 10
    You can use fractions for the rate (-r). This makes it easier and more accurate to specify times. 5min = 300 seconds ffmpeg -i MOVIE.mp4 -r 1/300 -vf scale=-1:120 -vcodec png capture-%02d.png. – DutGRIFF May 13 '14 at 18:28
  • avconv works in the same way, in case you don't have ffmpeg available (some Ubuntu releases). – Ken Sharp Mar 8 '16 at 3:25
  • 4
    This works, but requires plumbing through the entire video file. superuser.com/questions/538112/… provides some examples which attempt to find meaningful thumbnails, as well as avoid having to sit and process the entire video to get a few frames. – Skrylar May 21 '16 at 12:01
  • This does not add the timestamp to the image. – felwithe Aug 2 '17 at 23:08
  • How would you do this in batch for a bunch of videos in a directory? – Paul Jones Feb 7 '19 at 21:02

I like using an easy to use unix command line bash script called VCS - Video Contact Sheet. Their official page: http://p.outlyer.net/vcs/

Its a lot easier to use even easier than a GUI

''It is a bash script meant to create video contact sheets (previews) aka thumbnails or previews of videos. Any video supported by mplayer and ffmpeg can be used by this script. '' You will need to have either ffmpeg or mplayer installed on your system.


vcs input-filename -U0 -i 1m -c 3 -H 200 -a 300/200 -o save-filename.jpg

How the command works

Edit input-filname to the name of your video file!

  • -U0 (no name in footer - or else it displays the host name - note this is zero not the letter O)

  • -i 1m (sets the capture time interval in mins - in this case it's every minute - you could also use -n instead which sets the number of captures for example -n 21 will create 21 images, but don't use both)

  • -c sets number of columns (here it's 3 columns)

  • -H 200 -a 300/200 (sets size and aspect so file is not too big - seems you have to do both)

  • -o filename.jpg (use .jpg as the default as .png is too big - and change the filename to one of your choice !)


There is a solution from ffmpeg forum.

To make multiple screenshots and place them into a single image file (creating tiles), you can use FFmpeg's tile video filter, like this:

ffmpeg -ss 00:00:10 -i movie.avi -vf 'select=not(mod(n\,1000)),scale=320:240,tile=2x3' out.png

That will seek 10 seconds into the movie, select every 1000th frame, scale it to 320x240 pixels and create 2x3 tiles in the output image out.png.

Original post here - http://ffmpeg.gusari.org/viewtopic.php?f=25&t=597

  • Also, ffmpeg seems to support "crop" with the same syntax. – some ideas Sep 11 '15 at 16:23

This one seems to fit the bill, it's free and open source and even works on Windows :)

It even has advanced stuff, like instead of blindly picking any frame at the particular interval, it can pick ones that are close enough but don't look too blurry, so instead of doing this:


You can pass it a parameter (-D6) so it does this:

better screenshot

Plus I really like no borders, so that the images can be slightly bigger.


This tool helped me (2019-02) - and it is maintained. Many options - grid, quality, fonts, colors, border, interval, ...


Create video contact sheets. A video contact sheet is an image composed of video capture thumbnails arranged on a grid.

You only need ffmpeg and python.

  • This is very good - thank you! – Ashley Jan 2 '20 at 1:45
  • Amazing tool! Works perfectly – FloPinguin Jul 5 '20 at 19:45

This is how I process a simple contact sheet using AWS EC2, from my mac.

Step #1: Create an EC2 Instance at Amazon Web Services

I used:

Amazon Linux AMI 2015.03.1 (HVM), SSD Volume Type - ami-0d4cfd66

Step #2: Configure the instance

This is all run from my mac for convenience, but you could also run just the commands "sudu su..." from the EC2 command line.

ssh -i "/local/path/to/key/your_ec2_key.pem" ec2-user@ "sudo su root; curl -O http://ffmpeg.gusari.org/static/64bit/ffmpeg.static.64bit.latest.tar.gz"
ssh -i "/local/path/to/key/your_ec2_key.pem" ec2-user@ "sudo su root; gunzip ffmpeg.static.64bit.latest.tar.gz"
ssh -i "/local/path/to/key/your_ec2_key.pem" ec2-user@ "sudo su root; tar -xf ffmpeg.static.64bit.latest.tar"

Replacing with your EC2 IP.

Step #3: Process a video

Send the video:

rsync -Pav -e 'ssh -i /local/path/to/key/your_ec2_key.pem pem' /Users/mdouma/Desktop/myVideo.mov ec2-user@

Process it into a contact sheet:

ssh -i "/local/path/to/key/your_ec2_key.pem" ec2-user@ "rm -f out.png ; ./ffmpeg -ss 00:00:00 -i myVideo.mov -vf 'select=not(mod(n\,1)),scale=113:111,crop=111:111,tile=18x36' out.png"

Change /Users/mdouma to your local root Change the ",1" to some other number, e.g., ",7", if you only want every 7th frame. Change 111 to whatever size you want

Copy it back to my mac:

rsync -Pav -e 'ssh -i /local/path/to/key/your_ec2_key.pem'  ec2-user@  /Users/mdouma/Desktop/out.png
open /Users/mdouma/Desktop/out.png
  • This is a great tip. Note though that sudo su is aimless. – Ken Sharp Mar 8 '16 at 3:26
  • 5
    Why are you sending this to ec2? Why not just run it on your mac locally? the video files could be GBs large... – haventchecked Nov 28 '17 at 2:50
  • I suggest to consider using docker. – bohdan_trotsenko Mar 30 '20 at 7:59

The 'imagemagick' package has utilities for stuff like this.


There are API libraries using imagemajick for a bunch of languages too.

  • What would be the corresponding command? – student Feb 5 '13 at 11:50
  • convert is probably the most general one. Look at the section headed General Thumbnail Creation on the first page I linked to. – goldilocks Feb 5 '13 at 14:20

Totem - the default video player for 14.04 and some earlier versions of Ubuntu - has menu option with simple options (under Edit menu, "Create Screenshot Gallery..."). There's also a command-line equivalent(ish) called "totem-video-thumbnailer" which has a man page that tells you how to use it; I wrote a simple bash script that used output from the find command (taking care to not separate files with spaces in names) to auto-generate a thumbnail screenshot gallery (or contact-sheet as also referred to above) for any files above a certain size in a directory that didn't already have one.

I could upload it to my github under ~jgbreezer if anyone fancied hunting for it. Though solutions using ffmpeg and other things may be more flexible and reliable; I seem to get error outputs from the totem command about not finding certain frames but it seems to work anyway most of the time.


I wanted the same thing and googling ended up using ffmpeg and imagemagick. NOT 'fast' IMHO. Then found a bash script named SlickSlice (last updated 2008 but worked perfectly as of yesterday). Installed it and customized it to my liking using the configuration file and the script itself. The script uses ImageMagick and MPlayer by the way.

I made a detail how-to and customization after I successfully used it. Once installed successfully, you can generate video timeline thumbnail with as simple as command:
slickslice -x "InputFile.mp4" (default 4 column x 15 rows) or
slickslice -x "InputFile.mp4" -S 6x10 (for 6 column x 10 rows).

It outputs as SLICKSLICED_InputFile.mp4.jpeg and I customized it to produce InputFile.mp4-screen.jpeg by editing the bash script itself.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.