Simple PDF-CLI

Simple PDF-CLI is a simple Python CLI app to edit PDFs directly from the terminal. Install with pip: pip install simple-pdf-cli

Current features:

• Merge multiple PDFs
• Convert PDF to images
• Combine images to a PDF
• Reorder pages of a PDF
• Trim pages of a PDF
• Split a PDF into multiple PDFs
• Encrypt a PDF
• Decrypt a PDF
• Compress a PDF

Testing photos by Pavel Moiseev on Unsplash.

Note:

The PDF to Images feature requires poppler to function.

Windows

I recommend using Scoop for easy installation. scoop install poppler

Otherwise you can download manually from here and add the bin directory to PATH.

MacOS

You can use Homebrew to install. brew install poppler

Linux

Install poppler-utils with a package manager of your choice.

Usage Examples

Merge

pdfcli merge file1.pdf file2.pdf -o merged.pdf

Images to PDF

pdfcli image1.png image2.png image3.png -o output.pdf

PDF to Images

pdfcli file.pdf -o out_images

Reorder

pdfcli input.pdf -o output.pdf -r 3,1,2

Trim

pdfcli input.pdf -o output.pdf -p 1-5,7,10-12,9

Split

pdfcli split input.pdf -o out_pdfs -p 1-5,3-6,7

Encrypt

pdfcli encrypt file.pdf -o output.pdf -p password1

Decrypt

pdfcli decrypt file.pdf -o output.pdf -p password1

Compress

pdfcli compress input.pdf -o output.pdf -l 6 -q medium

Installation

Using pip (recommended):

pip install simple-pdf-cli

Manual Installation:

1. Clone the repo

git clone https://github.com/Falachi/simple-pdf-cli.git

2. Go to project directory

cd simple-pdf-cli

3. Install package

pip install -e .

To-Do List

• Implement proper type and error checking
• Compress PDF
• Split PDF
• Password protect
• Allow a .txt file as input for arguments that accept multiple files
• Edit PDF metadata
• Upload to PyPI
• Separate CLI and core functions
• Create a GUI version