How to Remove Pages from a PDF via Command Line (QPDF & PDFtk)

To remove pages from pdf command line environments, the fastest and most reliable open-source tool is QPDF. Unlike legacy utilities that require heavy Java virtual machines, QPDF is a C++ binary licensed under Apache-2.0 that executes page manipulation in milliseconds. Below are the tested one-liners for Linux, macOS, and Windows.

CLI Tool Comparison: QPDF vs PDFtk vs MuTool

Before scripting your deletion pipeline, evaluate which command line binary best fits your infrastructure:

Step 1: Install QPDF on Your Operating System

Step 2: The Core QPDF Command Line Syntax

In QPDF, page extraction is specified by defining the pages you wish to retain. The special letter z represents the final page of the document:

Step 3: Handling Exit Codes in Production Scripts

Unlike tools that return 1 on warning, QPDF has structured exit codes that are vital for automated bash and Python pipelines:

• Exit Code 0: Command executed cleanly without warnings or errors.
• Exit Code 2: Non-fatal warnings encountered (e.g., QPDF recovered damaged xref tables or fixed bad trailer offsets). The output file is valid and complete.
• Exit Code 3: Fatal error encountered (e.g., password protected file with missing credentials, invalid syntax, or corrupted stream). No output file is generated.

Automated Bash Batch Loop for Entire Directories

To prune page 1 from all PDF files inside a folder (such as stripping redundant cover pages from 500 invoices) with exit code validation:

#!/usr/bin/env bash
set -e

mkdir -p output_dir

for file in *.pdf; do
  [ -e "$file" ] || continue
  echo "Pruning page 1 from $file..."
  
  # Run QPDF retaining page 2 through final page (z)
  qpdf "$file" --pages . 2-z -- "output_dir/$file"
  exit_status=$?

  if [ $exit_status -eq 0 ] || [ $exit_status -eq 2 ]; then
    echo "Successfully generated output_dir/$file (status: $exit_status)"
  else
    echo "Error processing $file (fatal exit code $exit_status)" >&2
  fi
done

echo "Batch processing complete."

Frequently Asked Questions