Logo
Data Carver Processors: PDF PDF Print E-mail
Written by Keven Murphy   
Saturday, 22 August 2009 09:37

PDF Processor

This script takes PDF files turns them into animated GIFs.
* Creates a series of web pages that contains a thumbnail of all readable PDFs
* Gathers details about the files such as Exif data
* Can gather whatever data you can think of due to plugins

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, Ghostscript

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

  1. Install the listed Perl modules
  2. Install the other binary requirements such as Imagemagick and Ghostscript. 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.

Screenshots

Here are some screenshots. Click on the image to bring up a larger version.

Web Page

PDF Details

PDF Details Part 2

Running The Program

Commandline Example: ./pdf-processor.pl --inputdir /export/data_carver_processors/pdf_exam --output pdf-index --plugindir /export/data_carver_processors/pdf-plugins --ini /export/data_carver_processors/pdf_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 pdf-index.html in the directory where I ran pdf-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

Last Updated on Wednesday, 30 December 2009 19:13