Frame Extractor

News

May 7, 2003 - Version 1.2 released. Changes: Improved makefile, minor code clean-ups, used verbose option more.
December 04, 2002 - Webpage finished. Downloads made available.
November 26, 2002 - SourceForge project created. CVS set up. Webpage created.

Description

Frame Extractor is a tool for generating images from an mpeg file. It was designed for people who need to create thumbnails of their mpegs for use in a webpage.

Requirements

• Linux 2.4.4 or later on an x86 processor - Frame Extractor is based on libmpeg3-1.3 which requires linux 2.4.4 or later and an x86 processor.
• ImageMagick - Frame Extractor uses ImageMagick to create the images.
• nasm - In addition to normal build tools, nasm is required to compile libmpeg3-1.3

Download

Latest source package: FrameExtractor-1.2.tgz

or download from cvs:

$ cvs -z3 -d:pserver:anonymous@cvs.frameextractor.sourceforge.net:/cvsroot/frameextractor checkout FrameExtractor

Installing

To compile, simply run make. Optionally, you can run 'make install' to copy FrameExtractor to /usr/local/bin:

$ make
<lots of compiling...>
$ su
Password:
# make install

If you run into problems, you may email me (michael at snark dot com) with a description of your trouble.

Usage

FrameExtractor [OPTIONS]... <Mpeg File>
-h --help Print help and exit
-V --version Print version and exit
-oSTRING --output=STRING Base Filename for extracted frames
-tSTRING --imagetype=STRING Image output type (bmp, gif, png, etc.) defaults to bmp
-sINT --seconds=INT Number of seconds between each extracted frame
-fINT --frames=INT Number of frames that should be extracted
-gSTRING --geometry=STRING Geometry for output images.
-v --verbose Verbose (default=off)

Note that the --geometry option is in the form <width>x<height> where width and height represent the preferred width and height. If necessary, actual output resolution will be adjusted to preserve aspect ratio.

Examples

1. Read in movie.mpg and write 5 frames as jpegs. The frames will be named thumb000.jpg, thumb001.jpg, ... They'll be scaled to the largest size that preserves aspect ratio and is not bigger than 100x100.
   $ FrameExtractor -v -o thumb -t jpg -g 100x100 -f 5 movie.mpg
   FrameExtractor 1.2
   
   5 frames written. Output image size: 100x75
   
   
   
2. Read in movie.mpg and write a frame for every 5 seconds of video. Since no other options are given, defaults will be used: The output format will be bmp, the files will be named movie000.bmp, movie001.bmp, etc., and the output images will be the same resolution as movie.mpg.
   $ FrameExtractor -v -s 5 movie.mpg
   FrameExtractor 1.2
   
   3 frames written. Output image size: 320x240
   
   
   

Author

Michael Lehenbauer. I may be contacted with questions, comments, fixes, etc. at michael at snark.com

Contributors

• Woody Thrower. Funding, design.
• Jared Robinson. Makefile fixes, clean-up.

This project is hosted by