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.