pdf2jpg#

Overview#

Convert a PDF into JPEG page images using pdftoppm from poppler-utils, then optionally zip the generated JPGs.

Requirements#

• pdftoppm must be available in PATH
• Install the poppler-utils package before running the scripts

Install poppler-utils#

• Debian / Ubuntu: bash

  sudo apt update
  sudo apt install -y poppler-utils
  
  

• Windows:

  • Install Poppler via a package manager, then make pdftoppm.exe available in your PATH
  • Common options:
    • winget install -e --id oschwartz10612.Poppler
    • choco install poppler
    • scoop install poppler

• macOS: bash

  brew install poppler
  
  

Standard workflow#

1. Convert the PDF with scripts/pdf2jpg.sh
2. Bundle the output images with scripts/zip_jpgs.sh if needed

bash

./scripts/pdf2jpg.sh input.pdf
./scripts/pdf2jpg.sh input.pdf 2 5
./scripts/zip_jpgs.sh input.pdf
./scripts/zip_jpgs.sh input.pdf /tmp/output.zip

Scripts#

scripts/pdf2jpg.sh#

• Prompts for the PDF path if none is supplied
• Verifies the input file exists
• Verifies pdftoppm is installed and prints a poppler-utils install hint if not
• Writes JPEGs beside the PDF using the PDF basename as the output prefix
• Accepts optional first and last page arguments

scripts/zip_jpgs.sh#

• Finds matching basename-*.jpg files for the PDF
• Creates a zip archive containing those JPGs
• Uses ${base}-jpgs.zip by default when no output path is supplied

Notes#

• Output files follow the pdftoppm naming convention, typically basename-1.jpg, basename-2.jpg, etc.
• If you need different image quality, output naming, or archive behavior, edit the bundled scripts rather than reimplementing the command inline.