JPedal’s Free PDF Inspector Lets Developers Single-Step Through PostScript Streams

Most PDF debugging still comes down to hex editors or object dumps. The JPedal PDF Inspector is a free tool that gives you four interactive views into a PDF’s internals. You can download it as either part of the JPedal package or as a free standalone version.

COS Object Tree

The Object Viewer displays the full object tree with syntax highlighting per token type (dictionary keys, values, references, numbers, booleans, strings). Click any node to inspect its contents.

XRef Table and Stream Viewer

For traditional XRef tables, entries link directly to their referenced objects. For compressed XRef streams, the Inspector decodes the /W array and displays entries at their defined column widths. Type 2 compressed entries are automatically decompressed and shown in COS syntax.

Stream Debugger with Breakpoints

This is the feature with no equivalent in other free Java PDF tools. A decode slider lets you pause page rendering at any command and step forward one operator at a time, re-rendering at each step. You can set breakpoints on specific commands and resume to the next one, which makes isolating a single bad operator in a long content stream practical rather than tedious.

Command Search

The search function resolves text operators before matching, so it correctly finds strings inside TJ commands with individual glyph positioning – where a naive text search would fail.

The JPedal PDF Inspector is free, requires Java 17+, and has no other dependencies. It ships as a single JAR with no installation process, just download and run. It can be run as a standalone version or as part of the JPedal package. You can download the standalone version here, and full documentation is available on the JPedal support site.