Skip to content

Version 0.4.0: CLI and Documentation Alignment

Latest

Choose a tag to compare

@adambreen adambreen released this 21 Dec 04:00

Major Changes

  • Fixed misalignment between CLI implementation and documentation
  • Added dependency verification with --check-dependencies
  • Enhanced user experience with post-install messages
  • Updated installation docs to focus on pipx
  • Fixed mutool version check to handle non-zero exit code

Breaking Changes

  • Image extraction now only saves page images as PNG (removed embedded image extraction)
  • Requires Python 3.11.x and mutool

Installation

# Install pipx if you haven't already
brew install pipx  # macOS
# OR
python3 -m pip install --user pipx  # Other systems

# Install pdf_processor with Python 3.11 (required)
pipx install pdf_processor --python python3.11

# Verify installation
pdf-process --check-dependencies

System Requirements

  • Python 3.11.x (required by PyMuPDF)
  • mutool (part of MuPDF tools)

To install mutool:

# macOS
brew install mupdf

# Ubuntu/Debian
apt-get install mupdf-tools

# Arch Linux
pacman -S mupdf-tools