PDF to Images Converter
Convert PDF files into a series of images using ImageMagick.
Description
A simple yet powerful tool that converts PDF documents into individual PNG images, one per page. Useful for extracting slides from presentations, creating image previews, or processing PDF content for further analysis.
When to Use
Use this skill when users:
- Want to convert PDF to images
- Need to extract slides from PDF presentations
- Mention "PDF 转图片", "拆解 PDF", "PDF to PNG"
- Want to create image previews from PDF documents
- Need individual page images from multi-page PDFs
Features
- ImageMagick Powered: Industry-standard image processing
- Configurable DPI: Adjust output resolution (default: 150 DPI)
- Multiple Formats: Support PNG, JPG, TIFF output
- Batch Processing: Handles multi-page PDFs automatically
- Sequential Naming: Output files named with page numbers (slide-00, slide-01, etc.)
Usage
Basic Syntax
python scripts/pdf_to_images.py "PDF_FILE" [-o OUTPUT_DIR] [-d DPI] [-f FORMAT]Common Scenarios
Convert PDF to PNG images (default):
python scripts/pdf_to_images.py "presentation.pdf"Specify output directory:
python scripts/pdf_to_images.py "document.pdf" -o ./output-imagesHigh resolution output (300 DPI):
python scripts/pdf_to_images.py "document.pdf" -d 300Output as JPEG:
python scripts/pdf_to_images.py "document.pdf" -f jpg -q 90Arguments
pdf_file(required): Path to the PDF file-o, --output: Output directory (default: same directory as PDF, with-slidessuffix)-d, --dpi: Resolution in DPI (default: 150)-f, --format: Output format: png, jpg, tiff (default: png)-q, --quality: JPEG quality 1-100 (default: 85, only for jpg format)-p, --prefix: Output filename prefix (default: slide)
Dependencies
Requires ImageMagick installed on the system:
macOS:
brew install imagemagickUbuntu/Debian:
sudo apt-get install imagemagickWindows: Download from https://imagemagick.org/script/download.php
Output Structure
output-directory/
├── slide-00.png # Page 1
├── slide-01.png # Page 2
├── slide-02.png # Page 3
└── ...Claude Integration
When user requests PDF to images conversion:
- Check ImageMagick availability:
which magick || which convert - Execute conversion:
python /mnt/skills/user/pdf-to-images/scripts/pdf_to_images.py \ "USER_PDF_FILE" -o /mnt/user-data/outputs -d 150 - Present files to user:
present_files(["/mnt/user-data/outputs/..."])
How It Works
Workflow
- Validation: Check PDF file exists and ImageMagick is available
- Create Output Directory: Create output folder if not exists
- Convert: Use ImageMagick to convert each page to image
- Report: Display generated files and total count
ImageMagick Command
The script uses:
magick -density {DPI} "{input.pdf}" "{output_dir}/{prefix}-%02d.{format}"Or for older ImageMagick (v6):
convert -density {DPI} "{input.pdf}" "{output_dir}/{prefix}-%02d.{format}"Limitations
- Requires ImageMagick installed on system
- Large PDFs may take time to process
- Memory usage depends on PDF complexity and DPI setting
- Some secured PDFs may not be convertible
Common Issues
Q: Getting "convert: not authorized" error? A: Edit ImageMagick policy file to allow PDF reading:
sudo sed -i 's/rights="none" pattern="PDF"/rights="read|write" pattern="PDF"/' /etc/ImageMagick-*/policy.xmlQ: Output images are too small/large? A: Adjust DPI with -d flag. 150 DPI is good for screen, 300 DPI for print.
Q: Conversion is slow? A: Lower DPI reduces processing time. Try -d 100 for faster conversion.
Example Conversation
User: "帮我把这个 PDF 拆解成图片: presentation.pdf"
Claude:
# Check ImageMagick
which magick || which convert
# Convert PDF to images
python /mnt/skills/user/pdf-to-images/scripts/pdf_to_images.py \
"presentation.pdf" \
-o ./presentation-slides \
-d 150
# Present files
present_files(["./presentation-slides/slide-00.png", ...])Version History
v1.0 (Current)
- ImageMagick-based PDF conversion
- Configurable DPI and format
- Automatic output directory creation
- Support for PNG, JPG, TIFF formats
License
Personal use tool. Respects PDF document copyrights.