Introducing Agents.·Read
OverviewAgentsWorkflowsExecutionDeveloper ToolsSecurityLibrary
Updated Oct 19, 2026

Utilities

Extract embedded raster images from a PDF

pdf-images is a PDF image extraction node powered by Poppler pdfimages.

Agent
Recover embedded rastersLimit extraction by pagePreserve original pixel dimensions

overview

What pdf-images does

Extract embedded raster images from selected PDF pages as numbered PNG files at their original pixel dimensions.

This operation extracts image objects rather than rendering pages. It does not reproduce text, vector artwork or page composition. PNG decoding does not preserve the original compressed JPEG bytes. Transparency masks remain separate.

Input is at most 100 MiB; first-page defaults to 1 and page-count to 10, with at most 50 selected pages. Limits are 100 images, 25 million pixels per image and 100 million pixels total. Raster-free pages, invalid PDFs or exceeded limits fail without partial images.

This packaged operation uses 22.12.0-2+deb12u3. Upstream license: GPL-2.0-only OR GPL-3.0-only. The linked source identifies the actual program; this page documents the adapter's exposed contract.

source gitlab.freedesktop.org/poppler/poppler/-/tree/poppler-22.12.0

use cases

Where pdf-images fits

Recover embedded rasters

Extract raster image objects rather than rendering whole pages.

Limit extraction by page

Choose the first page and a bounded page count.

Preserve original pixel dimensions

Keep native embedded pixel dimensions in PNG output.

reference

pdf-images inputs and flags

3 inputs
NameTypeFlagDescription
inputFILE--inputPDF file up to 100 MiB. Filename extension does not matter. Selected pages must contain embedded raster images.
first-pageSTRING--first-pageFirst page, from 1 to 1000000. Defaults to 1.
page-countSTRING--page-countMaximum pages to inspect, from 1 to 50. Defaults to 10; stops at the end of the PDF. At most 100 images and 100M total pixels.

Showing key inputs. pdf-images exposes 3 inputs in total.

example

Run pdf-images

pdf-images · command
/app/run.sh --input ./input.txt --page-count 2 ./output

guidance

Choosing pdf-images

Use pdf-to-png for complete rendered page layouts. Use this operation when the original embedded raster dimensions matter, including small images displayed at larger sizes.

pdf-to-png

Renders complete page layouts, including text and vector graphics.

faq

pdf-images questions

input: PDF file up to 100 MiB. Filename extension does not matter. Selected pages must contain embedded raster images. first-page: First page, from 1 to 1000000. Defaults to 1. page-count: Maximum pages to inspect, from 1 to 50. Defaults to 10; stops at the end of the PDF. At most 100 images and 100M total pixels.

PNG image folder. This operation extracts image objects rather than rendering pages. It does not reproduce text, vector artwork or page composition. PNG decoding does not preserve the original compressed JPEG bytes. Transparency masks remain separate.

Input is at most 100 MiB; first-page defaults to 1 and page-count to 10, with at most 50 selected pages. Limits are 100 images, 25 million pixels per image and 100 million pixels total. Raster-free pages, invalid PDFs or exceeded limits fail without partial images.

Use pdf-to-png for complete rendered page layouts. Use this operation when the original embedded raster dimensions matter, including small images displayed at larger sizes.

The public image repository includes download instructions for this version and a separate source/notices bundle. Its overview provides an immutable ORAS command, the expected bundle checksum and pinned upstream source directions. The bundle contains the original build recipe, runtime sources and retained component license notices. Image, source and license notice downloads.

related

More Utilities tools

  1. browser-fetch

    Headless Chromium render: requested URL, final URL, status, and title next to the page.

  2. cewl

    Spider a URL and return a wordlist for password crackers.

  3. csvkit

    SQL on one CSV. The table name is the file stem.

  4. dnsgen

    Wordlist and mined-word subdomain permutation.

  5. duckdb

    In-process SQL on CSV, JSON, and Parquet. No server.

  6. edge-tts

    Microsoft Edge neural speech from text or a script file. No API key.

Run pdf-images yourself

The saved synthetic check verified two 2×2 PNG images and exact decoded red, green, blue and white pixels. Binary PNG artifacts are not embedded as a text sample. The command shows the container entrypoint with example paths.

Open pdf-images in the libraryBuild a workflow with it

Facts on this page come from the live Trickest tool library.