These examples demonstrate just a few of the facilities provided by the Coherent PDF Command Line Tools. See each chapter for more commands and full details.
cpdf in.pdf 1-3,6 -o out.pdf
Read in.pdf, select pages 1, 2, 3 and 6, and write those pages to out.pdf.
cpdf in.pdf even -o out.pdf
Select the even pages (2, 4, 6...) from in.pdf and write those pages to out.pdf.
cpdf -merge in.pdf in2.pdf AND -add-text "Copyright 2023"
Using AND to perform several operations in order, here merging two files together and adding a copyright stamp to every page.
cpdf -args args.txt
Read args.txt and use its contents as the command line arguments for cpdf.
cpdf -merge in.pdf in2.pdf -o out.pdf
Merge in.pdf and in2.pdf into one document, writing to out.pdf.
cpdf -split in.pdf -o Chunk%%%.pdf -chunk 10
Split in.pdf into ten-page chunks, writing them to Chunk001.pdf, Chunk002.pdf etc.
cpdf -split-bookmarks 0 in.pdf -utf8 -o @B.pdf
Split in.pdf on bookmark boundaries, writing each to a file whose name is the bookmark label.
cpdf -scale-page "2 2" in.pdf -o out.pdf
Scale both the dimensions and contents of in.pdf by a factor of two in x and y directions.
cpdf -scale-to-fit usletterportrait in.pdf -o out.pdf
Scale the pages in in.pdf to fit the US Letter page size, writing to out.pdf
cpdf -shift "26pt 18mm" in.pdf -o out.pdf
Shift the contents of the page by 26 pts in the x direction, and 18 millimetres in the y direction, writing to out.pdf
cpdf -rotate-contents 90 in.pdf -o out.pdf
Rotate the contents of the pages in in.pdf by ninety degrees and write to out.pdf.
cpdf -cropbox "0 0 600pt 400pt" in.pdf -o out.pdf
Crop the pages in in.pdf to a 600 pts by 400 pts rectangle.
cpdf -encrypt 128bit fred joe in.pdf -o out.pdf
Encrypt in.pdf using 128bit PDF encryption using the owner password fred and the user password joe and writing the encrypted file to out.pdf
cpdf -decrypt in.pdf owner=fred -o out.pdf
Decrypt in.pdf using the owner password, writing to out.pdf.
cpdf -compress in.pdf -o out.pdf
Compress the data streams in in.pdf, writing the result to out.pdf.
cpdf -decompress in.pdf -o out.pdf
Decompress the data streams in in.pdf, writing to out.pdf.
cpdf -squeeze in.pdf -o out.pdf
Squeeze in.pdf, writing to out.pdf. Squeezing rearranges the structure of the PDF file to save space.
cpdf -list-bookmarks -utf8 in.pdf
List the bookmarks in in.pdf.
cpdf -add-bookmarks bookmarks.txt in.pdf -o out.pdf
Add bookmarks in the same form from a prepared file bookmarks.txt to in.pdf, writing to out.pdf. JSON alternatives are also available.
cpdf -presentation in.pdf 2-end -trans Split -duration 10
Use the Split style to build a presentation from the PDF in.pdf, each slide staying 10 seconds on screen unless manually advanced. The first page, being a title does not move on automatically, and has no transition effect.
cpdf -stamp-on watermark.pdf in.pdf -o out.pdf
Stamp the file watermark.pdf on to each page of in.pdf, writing the result to out.pdf.
cpdf -topleft 10 -font Courier
-add-text "Page %Page\nDate %d-%m-%Y" in.pdf -o out.pdf
Add a page number and date to all the pages in in.pdf using the Courier font, writing to out.pdf.
cpdf -impose-xy "2 1" in.pdf -o out.pdf
Two up impose the file in.pdf, writing to out.pdf.
cpdf -pad-after in.pdf 1,3,4 -o out.pdf
Add extra blank pages after pages one, three and four of a document.
cpdf -list-annotations-json in.pdf > out.json
List the annotations in a file in.pdf to standard output, redirecting to file out.json.
cpdf -set-annotations-json out.json in.pdf -o out.pdf
Add the annotations from a JSON annotations file to in.pdf, writing to out.pdf.
cpdf -info -utf8 in.pdf -o out.pdf
List document metadata for in.pdf.
cpdf -set-title "The New Title" -also-set-xmp in.pdf -o out.pdf
Set the document title of in.pdf, writing to out.pdf.
cpdf -hide-toolbar true in.pdf -o out.pdf
Set the document in.pdf to open with the PDF Viewer’s toolbar hidden, writing to out.pdf.
cpdf -set-metadata metadata.xml in.pdf -o out.pdf
Set the metadata in a PDF in.pdf to the contents of the file metadata.xml, and write the output to out.pdf.
cpdf -set-page-layout TwoColumnRight in.pdf -o out.pdf
Set the document in.pdf to open in PDF Viewer showing two columns of pages, starting on the right, putting the result in out.pdf.
cpdf -set-page-mode FullScreen in.pdf -o out.pdf
Set the document in.pdf to open in PDF Viewer in full screen mode, putting the result in out.pdf.
cpdf -attach-file sheet.xls in.pdf -o out.pdf
Attach the file sheet.xls to in.pdf, writing to out.pdf.
cpdf -remove-files in.pdf -o out.pdf
Remove any attachments from in.pdf, writing to out.pdf.
cpdf -dump-attachments in.pdf -o /home/fred/attachments
Dump attachments to file, given the directory to put them in.
cpdf -image-resolution 600 in.pdf
Identify and list any image used at less than 600dpi.
cpdf -extract-images in.pdf -im /usr/bin/magick -o output/%%%
Extract images from in.pdf to directory output (with the help of imagemagick).
cpdf -list-fonts in.pdf
List the fonts in use, and what pages they are used on.
cpdf -list-missing-fonts in.pdf
List missing fonts.
cpdf in.pdf -output-json -output-json-parse-content-streams
Write the PDF in JSON format to the given file, parsing its content streams into individual JSON objects too.
cpdf -j in.json -o out.pdf
Load a PDF in JSON format, writing to an output PDF.
cpdf -ocg-list in.pdf
List the optional content groups by name.
cpdf -ocg-coalesce-on-name in.pdf -o out.pdf
Coalesce optional content groups after merging or stamping two files with OCGs with like names.
cpdf -create-pdf -create-pdf-pages 20
-create-pdf-papersize usletterportrait -o out.pdf
Create a US Letter PDF of twenty pages.
cpdf -typeset file.txt -create-pdf-papersize a3portrait
-font Courier -font-size 10 -o out.pdf
Typeset a text file as PDF on A3 paper with Courier 10 point font.
cpdf -create-pdf AND -draw -to "100 100" -line "400 400"
-line "400 100" -close -fill
Create a new PDF and draw a filled triangle on it.
cpdf -create-pdf AND -draw -mtrans "100 200" -font-size 50
-leading 55 -bt -text "This is" -nl -text "on multiple"
-nl -text "lines" -et -o out.pdf
Create a new PDF and draw three lines of text on it.
cpdf -blacktext in.pdf -o out.pdf
Blacken all the text in in.pdf, writing to out.pdf.
cpdf -thinlines 2pt in.pdf -o out.pdf
Make sure all lines in in.pdf are at least 2pts wide, writing to out.pdf.