Video Processor
This script will process any video that mplayer can read. It converts the videos into animated GIF images.
* Creates a series of web pages that contains a thumbnail of all readable videos
* Gathers details about the files such as Exif data
* Can gather whatever data you can think of due to plugins
Note: One of the "side" effects that I have seen reviewing videos with this script is that it can convert some damaged videos into viewable animated GIFs. See INI section for more details.
Requirements
Perl modules: Getopt::Long, Pod::Usage, File::Basename, Config::IniFiles, Startup, Image::ExifTool, Digest::MD5, Digest::SHA, Getopt::Std, Pod::Usage
Libraries and packages installed: Imagemagick, Mplayer (install Win32 Binary Codex Packages)
Standard Plugins
exif.pl -- Uses Exif to dump whatever metadata it can find in the file.
md5.pl -- Calculates the MD5 hash for the file.
sha.pl -- Calculates the SHA 512 has for the file.
Installation
-
Install the listed Perl modules
-
Install the other binary requirements such as Imagemagick, Ghostscript, and unoconv. If you're running Fedora, all three can be installed via yum.
INI File
The INI file (data_processor.ini) contains the user configurable options for each one of the data processor scripts.
Each line has a comment before the parameter. See the INI file for more details.
Frames Per Second and Frame Step Details
There are two options that you can use to adjust which frames are grabbed. So if you have a video file that will not play and the default options in the INI file do not seem to work you can try adjusting these settings. Once the settings have been adjusted, run the script again.
Frames Per Second (fps): This is how many frames in a second will be shown. The higher the number the more smoother the video will show.
Framestep: This is how many frames to "skip". It is my understanding that Mplayer will grab (# of fps frames) then "skip" the number defined by this variable.
Screenshots
Here are some screenshots. Click on the image to bring up a larger version.
Sample Secondary Page
(Where you clicked on the image)
Running The Program
Commandline Example: ./video-processor.pl --inputdir /export/data_carver_processors/video_exam --output video-index --plugindir /export/data_carver_processors/video-plugins --ini /export/data_carver_processors/video_processor.ini
After the program has gone through the documents, bring up your favorite web browser and open up the file you gave it with the --output option. In the above case, I would open up video-index.html in the directory where I ran video-processor.pl from.
Options
--ini FILE Ini File (configuration)
--title TITLE Head page with this title.
--inputdir DIR Input directory
--output FILE Name output file with this name instead "index.html"
--plugindir DIR Plugin directory
--imagenum NUMBER Number of thumbnails per page; default is 2000
--perrow NUMBER Number of thumbnails per row; default is 4
--imagesize NUMBER Size of the thumbnails in pixels; default is 150 pixels
--quality 0..100 Quality of the thumbnails from 0 to 100; default is 80
--help or --man Show this text and exits
Other Notes
Feedback: Please send me an email with any features/plug-ins you would like to see. If you find any errors with the scripts, let me know. I am also interested any plug-ins you want to share. If you like the program, let me know, too. I don't mind positive feedback.
Errors: As the script runs over the files you may see some errors outputted. The errors are from the programs running on the recovered files. Not all of the files that the data carvers recover are good files. Hence, the errors.
License: GPL 2.0
Download at: data_carver_processors.tar.gz (All of the data carver processor scripts are included in this file)
Contact: cs[at]citadelsystems.net |
