DUMPPDF(1)

💖 DUMPPDF 💖

okay bestie, listen up — this is the dumppdf(1) page from the User Commands section of the manual, and it's genuinely one of the most underrated little tools out there. It does exactly one thing and it does it gorgeously: it pops open a PDF and shows you its insides. ✨

---

🌸 NAME 🌸

dumppdf — extract pdf structure in XML format 🫶

Like. That's it. That's the whole job. No cap.

---

✨ SYNOPSIS ✨

dumppdf [-h] [--version] [--debug]
[--extract-toc | --extract-embedded EXTRACT_EMBEDDED]
[--page-numbers PAGE_NUMBERS [PAGE_NUMBERS ...]]  [--pagenos PAGENOS]
[--objects OBJECTS] [--all] [--password PASSWORD] [--outfile OUTFILE]
[--raw-stream | --binary-stream | --text-stream] files [files ...]

---

🦋 OPTIONS 🦋

💅 POSITIONAL ARGUMENTS

• files — one or more paths to PDF files. Give it a whole lil squad of PDFs if you want, it's not gonna complain. 👑

---

🌈 OPTIONAL ARGUMENTS

• -h, --help — shows you a help message and then dips. classic. 😌
• --version, -v — prints the program's version number and exits. main character announcement energy.
• --debug, -d — turns on debug logging level. for when you wanna see everything going on. 👀
• --extract-toc, -T — extracts the structure of the outline. the table of contents, bestie. the lore. 📖
• --extract-embedded EXTRACT_EMBEDDED, -E EXTRACT_EMBEDDED — extracts embedded files. yes, the little secret files hiding inside your PDF. we're freeing them. 🕊️

---

🧚 PARSER

used during PDF parsing — this is the part where it's actually reading your file.

• --page-numbers PAGE_NUMBERS [PAGE_NUMBERS ...] — a space-seperated list of page numbers to parse. (spelling is theirs, not mine, don't @ me 💀)
• --pagenos PAGENOS, -p PAGENOS — a comma-separated list of page numbers to parse. It's included for legacy applications; use --page-numbers for more idiomatic argument entry. so like… it still works, but it's giving old money. 🎀
• --objects OBJECTS, -i OBJECTS — comma separated list of object numbers to extract. just the objects you want, nothing extra. we love a curated queen. ✨
• --all, -a — if the structure of all objects should be extracted. yes. all of them. every single one. no crumbs left. 🔥
• --password PASSWORD, -P PASSWORD — the password to use for decrypting PDF file. unlocked. 🔓

---

⭐ OUTPUT

used during output generation — this is the part where it hands you the goods.

• --outfile OUTFILE, -o OUTFILE — path to file where output is written. Or - (default) to write to stdout. so if you don't say anything, it just yells into your terminal. respect. 💜
• --raw-stream, -r — write stream objects without encoding. raw. unfiltered. au naturel.
• --binary-stream, -b — write stream objects with binary encoding.
• --text-stream, -t — write stream objects as plain text. nice, readable, chill. 🍓

⚠️ heads up bestie — --extract-toc and --extract-embedded are on opposite sides of a | in the synopsis, so it's one or the other. same deal with --raw-stream, --binary-stream and --text-stream. pick your fighter. 💅

---

👑 SEE ALSO 👑

• pdf2txt(1) — the sibling. the other one. go say hi. 🫶

---

and that's the whole page, bestie!! this was the dumppdf(1) manual page from October 2021, filed under User Commands. 💖 mwah, go dump some PDFs, you got this. ✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜