n8n-nodes-pdf-to-image

Convert PDF files to images in n8n using poppler-utils.

Unlike other PDF-to-image packages, this one fully supports Linux!

Features

• ✅ Linux support (also macOS and Windows)
• 🖼️ Output formats: PNG, JPEG
• 🎨 Color modes: Color, Grayscale, Monochrome
• 📐 Configurable DPI (72-600)
• 📄 Page selection: All pages, first page only, or custom range
• 📦 Output as single item (all images) or multiple items (one per page)

Requirements

This node requires poppler-utils to be installed on your system.

Docker (n8n image)

FROM n8nio/n8n:latest

USER root
RUN apk add --no-cache poppler-utils
USER node

Debian/Ubuntu

sudo apt-get install poppler-utils

Alpine Linux

apk add poppler-utils

macOS

brew install poppler

Installation

In n8n

1. Go to Settings → Community Nodes
2. Enter n8n-nodes-pdf-to-image
3. Click Install
4. Restart n8n

Manual installation

cd ~/.n8n
npm install n8n-nodes-pdf-to-image

Usage

1. Add the PDF to Image node to your workflow
2. Connect a node that provides a PDF file as binary data
3. Configure the options:
   • Input Binary Field: Name of the binary property containing the PDF (default: data)
   • Output Format: PNG or JPEG
   • Color Mode: Color, Grayscale, or Monochrome
   • DPI: Resolution (72-600, default: 150)
   • Page Selection: All pages, first page only, or custom range
   • Output Mode: Single item with all images, or one item per page
   • Output Binary Field: Name for the output binary property (default: image)

Output

Single Item Mode

Returns one item with:

• json.totalPages: Number of pages converted
• json.format: Output format used
• json.colorMode: Color mode used
• json.dpi: DPI used
• json.images: Array of binary property names
• binary.image_1, binary.image_2, etc.: The converted images

Multiple Items Mode

Returns one item per page with:

• json.page: Page number
• json.totalPages: Total number of pages
• json.format: Output format used
• json.colorMode: Color mode used
• json.dpi: DPI used
• binary.image: The converted image

Example Workflow

[HTTP Request: Get PDF] → [PDF to Image] → [Upload to S3]

License

MIT

Author

Beltar

Contributing

Contributions are welcome! Please open an issue or submit a pull request.