Skip to content

Latest commit

 

History

History
112 lines (83 loc) · 4.07 KB

README.md

File metadata and controls

112 lines (83 loc) · 4.07 KB
Raw

merge2pdf - Merge Image and PDF files into PDF

Simplest command line tool for merging Images and PDFs. It will not convert PDF pages (with texts, images, forms) into flat image, everything will remain as is.

merge2pdf - simplest tool for merging image and PDF files

Highlights -

  • Very simple and easy to use
  • Lossless quality by default. Option to adjust JPEG quality.
  • Can be merged only selective pages of PDF
  • Supports wide range of image formats
  • Options to adjust size, margin and scaling of image
  • Supports directory as input (merges all Images/PDFs of directory)
  • Free and open source

Install

It's just a single binary file, no external dependencies. Just download the appropriate version of executable from latest release for your OS. Then rename and give it execute permission.

mv merge2pdf_linux-amd64 merge2pdf  
sudo chmod +x merge2pdf

If you want to install it globally (run from any directory of your system), put it in your systems $PATH directory.

sudo mv merge2pdf /usr/local/bin/merge2pdf

Done!

How to use

# Merge multiple PDFs
merge2pdf output.pdf input1.pdf input2.pdf path/to/other.pdf ...

# Merge 1st page of input1.pdf, full input2.pdf and 2nd, 3rd, 4th page of input3.pdf  
merge2pdf output.pdf input1.pdf~1 input2.pdf input3.pdf~2,3,4

# Merge multiple Images
merge2pdf output.pdf image1.jpg image2.jpg path/to/other.png ...

# Merge all Images/PDFs of one or multiple directory
merge2pdf output.pdf path/to/a/dir path/to/another ...

# Mixing up PDF, PDF Pages, Images and directories
merge2pdf output.pdf doc1.pdf~1,2 image1.jpg path/to/dir path/to/other.pdf ...

Fine tuning Image pages

When adding Images, by default the size for image containing pages will be same to image size with 1 inch margin on each side. But you may set custom margins and resize to standard Print size.

# Set image page size to A4. Other Options are A3, Legal and Letter
merge2pdf -s A4 output.pdf image1.jpg image2.jpg

# Set image page size and margin (left, right, top, bottom).
merge2pdf -s A3 -m .5,.5,1,1 output.pdf image1.jpg image2.jpg
# margin can be set without size

# Scale images to page width, with aspect ratio
# To scale to height, use --scale-height
merge2pdf -s A3 -m .5,.5,1,1 --scale-width output.pdf image1.jpg image2.jpg

# For JPEG, you can set optimized quality
merge2pdf -m 0,0,0,0 --jpeg-quality=80 output.pdf image1.jpg image2.jpg

Note: When adding images and PDFs together, these options will effect ONLY Image pages.

If your filename contains space or some special characters, then quote the filepaths along with page numbers. For safety, you can quote them always.

merge2pdf output.pdf "With Space.pdf" "without-space.pdf" "with space and pages.pdf~2,3,4"

To see details of options,

merge2pdf -h

Notes

  • --size, --margin, --scale-width, --scale-height will only effect images.
  • PDF pages will inherit size and margin of source PDF
  • Some .tiff files (e,g, compression level 4) may not work properly
  • Directory inputs will be searched for image/PDF files on first level only. Subdirectories will be skipped.

Roadmap

✅ Merge multiple PDFs without loosing quality
✅ Merge multiple PDFs with selective pages
✅ Adding Images
✅ Mixing up Images and PDFs
✅️ Merge all (Image and PDF) files from directory
✅ Option to Resize Images to reduce filesize
◻️ Option to Greyscale Images to reduce filesize
◻️ Option to set files and pages as JSON config to make usages from other app more convenient

Contribute

If you fix a bug or want to add/improve a feature, and it's alligned with the focus (merging with ease) of this tool, I will be glad to accept your PR. :)

Thanks

This tool was made using the beautiful Unidoc library. Thanks and ❤️ to Unidoc.

"This is the Book about which there is no doubt, a guidance for those conscious of Allah" - Al-Quran