🖼️ Image2PDF – Combine Images into a Single PDF

📑 Convert multiple images into a single PDF (f.e. many pages scanned in PNG format) 🖼️ Supports PNG, JPG, JPEG, BMP, TIFF, WEBP
⚡ Natural filename sorting (1.png, 2.png, 10.png)
✅ Transparency-safe: flattens images with alpha channels
🛠️ Simple CLI interface with customizable options

🔧 How to Run

Option 1: Quick Run

python make_pdf.py test_files -o output.pdf

Option 2: With Custom Extensions

python make_pdf.py test_files -o mydoc.pdf --extensions .png,.jpg

📁 Example Project Structure

image2pdf/
├── make_pdf.py         # Main CLI script
├── helpers.py          # Helper functions (sorting, loading, saving)
├── test_files/         # Your input images (not tracked in git)
├── requirements.txt
├── .gitignore
├── README.md

🖼️ Supported Formats

.png
.jpg / .jpeg
.bmp
.tiff
.webp

🚨 Features

Natural sort (no more 1, 10, 2 confusion)
Flatten transparency → ensures clean white background in PDF
Skips corrupted/unreadable images with a warning
Keeps the PDF small and lightweight

📦 Install Requirements

pip install -r requirements.txt

✅ Example Run

Input folder (test_files/):

Image (1).png
Image (2).png
Image (10).png

Command:

python make_pdf.py test_files -o my_album.pdf

Output:

✓ PDF created: my_album.pdf
   Pages: 3
   Included (in order):
   - Image (1).png
   - Image (2).png
   - Image (10).png

olkabul/image2pdf

README