pdftopng(1)

💖 pdftopng — the glow-up your PDFs have been waiting for 💖

okay bestie, sit down, hydrate, and let me tell you about pdftopng, a whole icon from the General Commands Manual collection. it's the PDF-to-PNG converter, version 4.06, and it literally just... does the thing. no cap.

---

✨ NAME ✨

pdftopng — Portable Document Format (PDF) to Portable Network Graphics (PNG) converter (version 4.06)

---

🌸 SYNOPSIS 🌸

pdftopng [options] PDF-file PNG-root

---

🦋 DESCRIPTION 🦋

so here's the vibe: pdftopng takes your Portable Document Format (PDF) files and turns them into color, grayscale, or monochrome image files in Portable Network Graphics (PNG) format. that's the whole main character arc.

it reads the PDF file, PDF-file, and then writes one PNG file for every single page — named PNG-root-nnnnnn.png, where nnnnnn is the page number. one page, one file, no skipping, no favorites. 💅

and if PNG-root is -, the image gets sent to stdout instead. ngl though, that's probably only useful when you're converting a single page — like, imagine piping a 400-page PDF through there, chaos. 🙈

---

🎀 CONFIGURATION FILE 🎀

pdftopng reads a configuration file at startup, because it's a little extra like that. first it tries to find your private config file, ~/.xpdfrc. if that one doesn't exist, it goes looking for a system-wide config file — typically /etc/xpdfrc (though this location can be changed when pdftopng is built, iykyk).

for all the juicy details, go read the xpdfrc(5) man page. 🫶

---

💅 OPTIONS 💅

a bunch of these can also be set with configuration file commands — those are listed in square brackets next to the matching command line option, so you always know who's who. ✨

• -f number — specifies the first page to convert.
• -l number — specifies the last page to convert.
• -r number — specifies the resolution, in DPI. the default is 150 DPI.
• -mono — generate a monochrome image (instead of a color image).
• -gray — generate a grayscale image (instead of a color image).
• -alpha — generate an alpha channel in the PNG file. this is only useful with PDF files that have been constructed with a transparent background. also, important: the -alpha flag cannot be used with -mono. pick a lane, babe. 😭
• -rot angle — rotate pages by 0 (the default), 90, 180, or 270 degrees.
• -freetype yes | no — enable or disable FreeType (a TrueType / Type 1 font rasterizer). this defaults to "yes". [config file: enableFreeType]
• -aa yes | no — enable or disable font anti-aliasing. this defaults to "yes". [config file: antialias]
• -aaVector yes | no — enable or disable vector anti-aliasing. this defaults to "yes". [config file: vectorAntialias]
• -opw password — specify the owner password for the PDF file. providing this will bypass all security restrictions. (slay, but also, respectfully, use this power wisely 🔥)
• -upw password — specify the user password for the PDF file.
• -verbose — print a status message (to stdout) before processing each page. [config file: printStatusInfo]
• -q — don't print any messages or errors. silent treatment, but make it functional. [config file: errQuiet]
• -cfg config-file — read config-file in place of ~/.xpdfrc or the system-wide config file.
• -v — print copyright and version information.
• -h — print usage information. (-help and --help are equivalent.)

---

⭐ EXIT CODES ⭐

the Xpdf tools use these exit codes, and they are iconic in their simplicity:

1. 0 — No error. (we love a clean exit 👑)
2. 1 — Error opening a PDF file.
3. 2 — Error opening an output file.
4. 3 — Error related to PDF permissions.
5. 98 — Out of memory.
6. 99 — Other error.

---

👑 AUTHOR 👑

the pdftopng software and documentation are copyright 1996-2025 Glyph & Cog, LLC. periodt.

---

🌈 SEE ALSO 🌈

xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdffonts(1), pdfdetach(1), pdftoppm(1), pdfimages(1), xpdfrc(5)

http://www.xpdfreader.com/

---

ok that's the whole page bestie, go forth and convert 💖

and that's a wrap on this little saga — brought to you from the 14 Nov 2025 edition of the pdftopng(1) manual page. mwah. 💅✨🎀