🗂️ Merge PDFs — Tiny Command‑Line PDF Merger

A minimalist Python CLI that merges all PDFs in a folder alphabetically into a single file. Built for speed and simplicity — no drag‑and‑drop, no bloat, just one clean command. Thanks to my husband for needing this tool and giving me the idea!

merge-pdfs ~/Documents/invoices -o combined.pdf

✨ Features

  • 🧩 Works both as a stand‑alone script or CLI tool (pip install -e .)
  • 📁 Automatically scans and merges .pdf files alphabetically
  • 🔍 Supports dry‑run, verbose output, and custom output paths
  • ⚡ Perfect for automating reports, invoices, or scanned documents

🧠 Why I Made It

My husband needed to merge PDFs quickly and I decided to build a CLI tool to do it without using a heavy app or dragging files into a UI because I really didn’t want to waste time with finding an app that will charge you $10 for a simple task. This script does it in one command — fast, portable, and under my control.

🛠️ My first experiment building a CLI with argparse — small, fast, and practical!

🚀 Quick Start

# Merge all PDFs in the current folder
merge-pdfs

# Merge from a specific folder with custom output
merge-pdfs ~/Documents/reports -o summary.pdf -v

🔗 Links