Command-line utility for merging, splicing, and rotating PDF documents.
Project description
pdfmerge
Command-line utility for merging, splicing, and rotating PDF documents.
Changelog - Issues - Documentation
Why?
I find myself merging bits of different PDFs fairly regularly and really wanted a simple CLI way to do it.
Install
python -m pip install pdfmerge
Usage
$ pdfmerge [-h] [--version] [-o FILE|--output FILE] [-p PASSWORD|--password PASSWORD] PATH[RULE[, RULE ...]] [PATH[RULE, ...]] ...]
-
-o
,--output
output file (default:output.pdf
). Must not be any of the input files. -
-p
, '--password` password for encrypted files (default: empty string). -
PATH
a file, directory, or wildcard string (e.g.,file*.pdf
) of files to merge. -
RULE
an optional string indicating which pages to extract and rotate. The syntax for each rule is:[START][..][END][ROTATE]
Where
START
andEND
are positive (1-based) or negative page numbers andROTATE
is one of>
,V
, or<
indicating a clockwise rotation of 90, 180, 270 degrees, respectively.
Command-line Example
$ pdfmerge -o out.pdf file1.pdf file2.pdf[3,3] file2.pdf[1V,2..-1] "other*.pdf[<]" "/path/pdf[1..4>,5]"
This example illustrates several features:
- specifying an output file (must not be any of the input files)
- merging multiple files, some more than once
- splicing parts of file using indices (1-based; negatives allowed)
- including the same page multiple times
- rotating a page or page range
- merging all the PDFs in a directory
Python Module Usage
pdfmerge
can also be imported into python scripts.
from pdfmerge import pdfmerge
pdfmerge(["pdf-1.pdf", "pdf-2.pdf[2>]"], "output.pdf")
License
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.