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 (JPG) files to a PDF file. Each page of the PDF file contains one of the JPEG images. So, you can make one document of a list of cartoons, photos or scanned images.

Features

jpeg2pdf has the following features:

Download

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

ZIP
http://koan.studentenweb.org/software/jpeg2pdf-0.12.zip (30 kB)
gzipped tar
http://koan.studentenweb.org/software/jpeg2pdf-0.12.tgz (20 kB)
bzipped tar
http://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 1.8 installed. Ruby can be found at http://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 http://koan.studentenweb.org/software/jpeg2pdf.html. Feel free to submit feature requests or bug reports. You can email the author at kvervloesem@gmail.com. For bug reports, please be as complete as possible. List the version of jpeg2pdf (jpeg2pdf -V), the version of Ruby (ruby -v) and your operating system. If possible, list the exact command you type and the error(s) jpeg2pdf gives.

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

Copyright (c) 2004 Koen Vervloesem. All rights reserved.

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.

Copyright

Author:
Koen Vervloesem <kvervloesem@gmail.com>
Copyright:
Copyright (c) 2004 Koen Vervloesem. All Rights Reserved.
License:
X11 License