Skip to main content

** Home page **

http://peepdf.eternal-todo.com http://twitter.com/peepdf

** Dependencies **

** Installation **

Run, in peepdf directory

easy_install .

The setup script handles the installation of jsbeautifier, colorama, pythonaes and lxml

** Execution **

There are two important options when peepdf is executed:

-f: Ignores the parsing errors. Analysing malicious files propably leads to parsing errors, so this parameter should be set. -l: Sets the loose mode, so does not search for the endobj tag because it’s not obligatory. Helpful with malformed files.

  • Simple execution

Shows the statistics of the file after being decoded/decrypted and analysed:

peepdf.py [options] pdf_file

  • Interactive console

Executes the interactive console to let play with the PDF file:

peepdf.py -i [options] pdf_file

If no PDF file is specified it’s possible to use the decode/encode/js*/sctest commands and create a new PDF file:

peepdf.py -i

  • Batch execution

It’s possible to use a commands file to specify the commands to be executed in the batch mode. This type of execution is good to automatise analysis of several files:

peepdf.py [options] -s commands_file pdf_file

** Updating **

The option has been desactivated as it is not working for now. To update, cd to peepdf directory and type:

git pull origin master easy_install .

** Some hints **

If the information shown when a PDF file is parsed is not enough to know if it’s harmful or not, the following commands can help to do it:

  • tree

Shows the tree graph of the file or specified version. Here we can see suspicious elements.

  • offsets

Shows the physical map of the file or the specified version of the document. This is helpful to see unusual big objects or big spaces between objects.

  • search

Search the specified string or hexadecimal string in the objects (decoded and encrypted streams included).

  • object/rawobject

Shows the (raw) content of the object.

  • stream/rawstream

Shows the (raw) content of the stream.

  • The rest of commands, of course

> help

** Bugs **

Send me bugs and comments, please!! ;) You can do it via mail (jesparza AT eternal-todo.com) or through Github (https://github.com/jesparza/peepdf/issues).

Thanks!!

Metadata

Release files for peepdf 0.3.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for peepdf 0.3.6
File Size Uploaded Provenance Actions
peepdf-0.3.6.tar.gz 113.4 kB Without provenance Details for peepdf-0.3.6.tar.gz

Release files / peepdf-0.3.6.tar.gz

Download URL peepdf-0.3.6.tar.gz
Size 113.4 kB
Tags Source
SHA-256 checksum
How to use checksums
dbb3e61cf2342758d1bd84d9c2135507719ec61788ae6c0c2d04e038231ef9ac
BLAKE2b-256 checksum
How to use checksums
9601cc8a353a5e87f69fef9ee94b563e15240c57aa3e1cbe4f4544ef7ffd20d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for peepdf 0.3.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page