truepolyglot

Truepolyglot is polyglot file generator project. It means the generated file is composed of several file formats. The same file can be opened as a ZIP file and as a PDF file for example. The idea of this project comes from the work of Ange Albertini, International Journal of Proof-of-Concept or Get The Fuck Out and Julia Wolf that explain how we can build a polyglot file.
Polyglot file can be boring to build, even more if you want to respect the file format correctly.
That's why I decided to build a tool to generate them.
My main motivation was the technical challenge.

⚠️ FORKED

This repository is forked from truepolyglot.hackade.org and includes a few commits to provide a setup.py for pip-installations along with a number of other opinionated changes.

You can install this version from master with:

pip install git+https://github.com/ansemjo/truepolyglot

Notably, this fork uses PyPDF2's cloneReaderDocumentRoot, which may hiccup on malformed PDFs more easily but copies the entire document including cross-references and section labels. The setup.py also installs a command pdfzip, which only creates polyglot files of this particular format since I believe this to be the most useful output format:

pdfzip -p document.pdf -z archive.zip polyglot.zip.pdf

Below you find the rest of the original README. Parts of it may be outdated and may not apply to this fork. For example I did not test compatability beyond Firefox and Evince.

Features and versions

Polyglot file compatibility

Examples

Usage

usage: truepolyglot format [options] output-file

Generate a polyglot file.

Formats availables:
* pdfzip: Generate a file valid as PDF and ZIP. The format is closest to PDF.
* zippdf: Generate a file valid as ZIP and PDF. The format is closest to ZIP.
* szippdf: Generate a file valid as ZIP and PDF. The format is strictly a ZIP. Archive is modified.
* pdfany: Generate a valid PDF file with payload1 file content as the first object or/and payload2 file content as the last object.
* zipany: Generate a valid ZIP file with payload1 file content at the start of the file or/and payload2 file content between LFH and CD.

positional arguments:       {pdfzip,zippdf,szippdf,pdfany,zipany}
Output polyglot format
output_file           Output polyglot file path

optional arguments:
-h, --help            show this help message and exit
--pdffile PDFFILE     PDF input file
--zipfile ZIPFILE     ZIP input file       
--payload1file PAYLOAD1FILE Payload 1 input file       
--payload2file PAYLOAD2FILE Payload 2 input file 
--acrobat-compatibility Add a byte at the start for Acrobat Reader compatibility with the szippdf format       
--verbose {none,error,info,debug} Verbosity level  (default: info)

TruePolyglot v1.6.2

Code

git clone https://git.hackade.org/truepolyglot.git/

or download truepolyglot-1.6.2.tar.gz

How to detect a polyglot file ?

You can use binwalk on a file to see if composed of multiple files.

Contact

[email protected]

Credits

Copyright © 2018-2019 [email protected]

TruePolyglot is released under Unlicence except for the following libraries:

• PyPDF2
• zipfile.py (cpython)