convert - Convert PDF to PowerPoint

Converts a PDF document to PowerPoint format, creating one slide per PDF page with customizable quality settings.

Usage:

pdf-to-pptx-tool convert INPUT_PDF OUTPUT_PPTX [OPTIONS]

Arguments:

• INPUT_PDF: Path to input PDF file (required)
  • Must exist and be a valid PDF file
  • Supports any PDF version
  • No size limit (memory permitting)
• OUTPUT_PPTX: Path to output PowerPoint file (required)
  • Will be created or overwritten
  • Extension should be .pptx
  • Parent directory must exist
• --dpi INTEGER: Resolution for page conversion (optional)
  • Default: 200 DPI (good quality, reasonable size)
  • Range: 72-600 DPI
  • Higher DPI = better quality but larger files
  • Recommended: 200-300 for presentations
• -v, --verbose: Multi-level verbosity
  • No flag: Warnings/errors only
  • -v: INFO level (operations and progress)
  • -vv: DEBUG level (detailed steps)
  • -vvv: TRACE level (library internals)

Examples:

# Example 1: Basic conversion (default 200 DPI)
pdf-to-pptx-tool convert quarterly-report.pdf q4-presentation.pptx

# Example 2: High quality for detailed diagrams
pdf-to-pptx-tool convert technical-diagram.pdf slides.pptx --dpi 300

# Example 3: Lower quality for quick preview
pdf-to-pptx-tool convert draft.pdf preview.pptx --dpi 150

# Example 4: With INFO logging to see progress
pdf-to-pptx-tool -v convert large-doc.pdf output.pptx

# Example 5: With DEBUG logging for troubleshooting
pdf-to-pptx-tool -vv convert problematic.pdf fixed.pptx

# Example 6: Batch conversion with shell loop
for pdf in *.pdf; do
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx"
done

Output:

• Creates PowerPoint file at specified path
• Slide properties:
  • Aspect ratio: 16:9 (widescreen)
  • Dimensions: 10" × 5.625"
  • Layout: One full-slide image per PDF page
  • Background: Transparent
• Console output:
  • Success: "✓ Successfully converted input.pdf to output.pptx"
  • Error: "✗ Error: [detailed error message]"
• Exit codes:
  • 0: Success
  • 1: Error (file not found, invalid input, conversion failed)

completion - Generate shell completion scripts

Generates shell completion scripts for bash, zsh, or fish shells.

Usage:

pdf-to-pptx-tool completion SHELL

Arguments:

• SHELL: Shell type (required)
  • Options: bash, zsh, fish
  • Case-insensitive

Examples:

# Generate bash completion
eval "$(pdf-to-pptx-tool completion bash)"

# Generate zsh completion
eval "$(pdf-to-pptx-tool completion zsh)"

# Generate fish completion
pdf-to-pptx-tool completion fish | source

# Save to file for permanent installation
pdf-to-pptx-tool completion bash > ~/.pdf-to-pptx-tool-completion.bash
echo 'source ~/.pdf-to-pptx-tool-completion.bash' >> ~/.bashrc

Output: Shell-specific completion script printed to stdout.

Multi-Level Verbosity Logging

The tool supports progressive verbosity levels for debugging and monitoring conversions.

Logging Levels:

Examples:

# Quiet mode - only see errors
pdf-to-pptx-tool convert input.pdf output.pptx

# INFO - see conversion progress
pdf-to-pptx-tool -v convert input.pdf output.pptx
# Output:
# [INFO] Starting PDF to PPTX conversion
# [INFO] Converting input.pdf to output.pptx (DPI: 200)
# [INFO] Converting PDF pages to images...
# [INFO] Converted 5 pages
# [INFO] Creating PowerPoint presentation...
# [INFO] Saving presentation to output.pptx

# DEBUG - see detailed processing
pdf-to-pptx-tool -vv convert input.pdf output.pptx
# Additional output:
# [DEBUG] Input: input.pdf, Output: output.pptx, DPI: 200
# [DEBUG] Validating input file: input.pdf
# [DEBUG] Input file size: 2.45 MB
# [DEBUG] Using DPI setting: 200
# [DEBUG] Processing slide 1/5
# [DEBUG] Output file size: 8.23 MB

# TRACE - see library internals
pdf-to-pptx-tool -vvv convert input.pdf output.pptx
# Shows pdf2image, PIL, and pptx library debug messages

DPI Quality Guidelines

Choose DPI based on your use case:

Trade-offs:

• Higher DPI: Better quality, larger file size, slower conversion
• Lower DPI: Faster conversion, smaller files, lower quality
• Sweet spot: 200-300 DPI for most presentations

Batch Processing

Process multiple PDFs efficiently:

# Convert all PDFs in directory
for pdf in *.pdf; do
  echo "Converting $pdf..."
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx"
done

# With custom DPI
for pdf in *.pdf; do
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx" --dpi 300
done

# With error handling
for pdf in *.pdf; do
  if pdf-to-pptx-tool -v convert "$pdf" "${pdf%.pdf}.pptx"; then
    echo "✓ Converted $pdf"
  else
    echo "✗ Failed to convert $pdf"
  fi
done

Shell Completion

Enable tab completion for faster usage:

# Bash - add to ~/.bashrc
eval "$(pdf-to-pptx-tool completion bash)"

# Zsh - add to ~/.zshrc
eval "$(pdf-to-pptx-tool completion zsh)"

# Fish - save to completions directory
mkdir -p ~/.config/fish/completions
pdf-to-pptx-tool completion fish > ~/.config/fish/completions/pdf-to-pptx-tool.fish

Benefits:

• Tab-complete commands: pdf-to-pptx-tool <TAB>
• Tab-complete options: pdf-to-pptx-tool convert --<TAB>
• Tab-complete file paths automatically

Common Issues

Issue: "poppler not found" or PDF conversion fails

# Symptom
RuntimeError: Failed to convert PDF pages: poppler not found

Solution: Install poppler system library:

# macOS
brew install poppler

# Ubuntu/Debian
sudo apt-get install poppler-utils

# Fedora
sudo dnf install poppler-utils

# Verify installation
pdftoppm -v

Issue: "File not found" error

# Symptom
✗ Error: Input PDF file not found: document.pdf

Solution:

• Verify file path is correct
• Use absolute paths if needed
• Check file permissions

# Check file exists
ls -l document.pdf

# Use absolute path
pdf-to-pptx-tool convert /full/path/to/document.pdf output.pptx

Issue: Output file is too large

# Symptom
Generated 50MB PPTX from 2MB PDF

Solution: Reduce DPI setting:

# Try lower DPI
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 150

# Or use default 200 DPI
pdf-to-pptx-tool convert input.pdf output.pptx

Issue: Images look blurry in PowerPoint

# Symptom
Text and diagrams appear pixelated

Solution: Increase DPI setting:

# Use higher quality
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 300

# For print quality
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 600

Issue: Conversion is very slow

# Symptom
Large PDF takes minutes to convert

Solution:

1. Use DEBUG logging to see progress:

pdf-to-pptx-tool -vv convert large.pdf output.pptx

2. Consider lower DPI for faster conversion:

pdf-to-pptx-tool convert large.pdf output.pptx --dpi 150

3. Split large PDF into chunks and convert separately

Issue: Permission denied writing output file

# Symptom
PermissionError: [Errno 13] Permission denied: 'output.pptx'

Solution:

• Check directory write permissions
• Use different output location

# Write to home directory
pdf-to-pptx-tool convert input.pdf ~/output.pptx

# Or create directory first
mkdir -p output-dir
pdf-to-pptx-tool convert input.pdf output-dir/output.pptx

Getting Help

# Tool help
pdf-to-pptx-tool --help

# Command help
pdf-to-pptx-tool convert --help

# Completion help
pdf-to-pptx-tool completion --help

# Version info
pdf-to-pptx-tool --version

Debug Workflow

When conversion fails, use this debugging workflow:

# 1. Check file exists and is readable
ls -lh document.pdf
file document.pdf

# 2. Verify poppler is installed
pdftoppm -v

# 3. Try with DEBUG logging
pdf-to-pptx-tool -vv convert document.pdf test.pptx

# 4. Try with lower DPI if memory issues
pdf-to-pptx-tool -vv convert document.pdf test.pptx --dpi 150

# 5. Check Python and dependencies
python --version
pdf-to-pptx-tool --version