NAME

origami

DESCRIPTION

Origami is a framework written in Ruby designed to parse, analyze, and forge PDF documents. This is not a PDF rendering library, it aims at providing a scripting tool for generating and analyzing malicious PDF files. As well, it can be used to create on-the-fly customized PDFs, or to inject evil code into already existing documents.

VERSION

1.2

OPTIONAL DEPENDENCIES

• Ruby-GTK2 (only for GUI), http://ruby-gnome2.sourceforge.jp/
• Ruby with OpenSSL support
• TheRubyRacer gem (only for JavaScript support)

INSTALL

Stable: gem install origami Devel: hg clone https://origami-pdf.googlecode.com/hg/ origami

DIRECTORIES

lib/ Core scripts used to parse a PDF file. All objects and features are provided here.

samples/ Many samples, mostly sorted to generate specially crafted PDFs.

bin/ Useful tools based on Origami.

test/ Test case units.

HOMEPAGE

http://aslr.fr/pages/Origami

CONTRIBUTORS

Guillaume Delugré <guillaume (at) security-labs.org> - Author Frédéric Raynal <fred (at) security-labs.org> - Contributor

LICENSE

This software is distributed under the LGPL license. See the COPYING.LESSER file for more details.

Exception is for the PDF Walker graphical interface located in subdirectory bin/gui, which is distributed under the GPL license. See bin/gui/COPYING file for more details.

NOTES

It contains many bugs and many incomplete features. If you encounter a problem, feel free to report it by mail at <guillaume [at] security-labs [dot] org>, with a short explanation of what you did and any necessary PDF documents. Thanks.