jpeg2pdf - Convert a bunch of JPEG files to a PDF

Version:

0.12

Date:

2004-10-18

Description

jpeg2pdf is a free program that converts a directory of JPEG files to a PDF file.

Features

jpeg2pdf has the following features:

jpeg2pdf is fast. Unlike ImageMagick or other general image conversion tools, jpeg2pdf is specialized for its task an does this very efficiently.
jpeg2pdf generates compact PDF files. Unlike general image conversion tools, jpeg2pdf doesn`t do any processing/rescaling of the images, nor does it generate thumbnails of the pages in the PDF file.
jpeg2pdf is cross-platform. It works on any platform the Ruby programming environment runs on. This includes Windows 95/98/NT/XP, GNU/Linux, Mac OS X, Solaris, AIX, OS/2 and DOS.
jpeg2pdf is a command-line program. So it can very easily be integrated in a shell script or a web server process to automate a conversion task.
jpeg2pdf is free. You can download it and use it for free.

Download

The latest version of jpeg2pdf can be obtained in the following formats:

ZIP: koan.studentenweb.org/software/jpeg2pdf-0.12.zip (30 kB)
gzipped tar: koan.studentenweb.org/software/jpeg2pdf-0.12.tgz (20 kB)
bzipped tar: koan.studentenweb.org/software/jpeg2pdf-0.12.tar.bz2 (18 kB)

Installation

Unpack the downloaded package and install jpeg2pdf with the following command from its directory:

ruby install.rb

This command may require root privileges.

This assumes you have Ruby installed. Ruby can be found at www.ruby-lang.org/en/20020102.html.

Usage

jpeg2pdf is invoked from the command-line using:

jpeg2pdf [options] <directory> <pdf>

<directory> is the name of the directory containing the JPEG files which should be converted. <pdf> is the name of the PDF file which has to be generated.

The options are:

-r, --recursive
      Process directories recursively. Without this option, jpeg2pdf
      doesn't process JPEG files in subdirectories of the specified
      directory.

-a, --all
      Process all files, including hidden files (files whose name
      begins with a dot (".")). Without this option, jpeg2pdf doesn`t
      process hidden files.

-v, --verbose
      Give more output. This shows the name of each processed image
      on the screen.

-h, --help
      Give usage information.

-V, --version
      Show the version number of jpeg2pdf.

All files in <directory> will be checked, and if it’s a JPEG file, it will be added to the PDF. They will be added in the alphabetical order of the filenames. If the recursive option is used, directories will be processed and this will happen in alphabetical order, together with the files. E.g. with a file named “E.jpeg”, a directory named “F” with files “A.jpeg” and “B.jpeg”, and a file “G.jpeg”, the files will be processed in this order: “E.jpeg”, “F/A.jpeg”, “F/B.jpeg” and “G.jpeg”.

Note: jpeg2pdf doesn’t look at the file extension, such as .jpeg or .jpg, to find JPEG images. So, even a JPEG file without extension, or with a wrong extension, is recognized by jpeg2pdf.

Support

The jpeg2pdf homepage is located at koan.studentenweb.org/software/jpeg2pdf.html. Feel free to submit feature requests or bug reports. You can email the author at [email protected].

Acknowledgments

Thanks to:

Filip Vervloesem: who gave me the inspiration to write jpeg2pdf because he didn’t find any decent program for this task.
Ewoud Nuyts: for some bugfixes and his urge to make it able to handle thousands of JPEG files very efficiently.

License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, provided that the above copyright notice(s) and this permission notice appear in all copies of the Software and that both the above copyright notice(s) and this permission notice appear in supporting documentation.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.

Adobe Intellectual Property

This software is based on Adobe’s PDF Reference, Fourth Edition, describing the Adobe Portable Document Format, Version 1.5. There may be limitations on the use of this program based on intellectual property restrictions from Adobe.