History

Dan Puttick e19064c83f Refactor FileBase to store props as attributes * This is kind of a big refactoring - I realized that storing file props in a dict was causing some subtle problems, and that just having them as attributes makes things a lot more simple * I considered making a separate FileProps object and nesting it inside FileBase, but almost all FileBase methods concern manipulating file props, so it didn't really make sense. * Tests are almost passing with this commit, but need a few more changes and fixes for full test coverage + all passing.		2017-07-12 17:58:39 -04:00
..
README.md	Move non-filecheck.py binaries into examples directory	2017-01-19 15:25:08 -05:00
__init__.py	Do not use subprocess.	2015-10-27 10:24:45 +01:00
filecheck.py	Refactor FileBase to store props as attributes	2017-07-12 17:58:39 -04:00

README.md

filecheck.py

This is the script used by the CIRCLean USB key sanitizer. It is designed to handle a range of file types, and will mark them as dangerous if they meet certain criteria.

Before installing the filecheck.py depenencies, make sure to install the PyCIRCLean dependencies:

    pip install .

Dependencies by type of document:

Microsoft office: oletools, olefile
OOXML: officedissector
PDF: pdfid
Archives: p7zip-full, p7zip-rar
Metadata: exifread
Images: pillow

Note: pdfid is a not installable with pip. It must be downloaded and installed manually in the directory where filecheck will be run.

    sudo apt-get install p7zip-full p7zip-rar libxml2-dev libxslt1-dev
    pip install lxml oletools olefile pillow exifread
    pip install git+https://github.com/Rafiot/officedissector.git
    # installing pdfid manually
    wget https://didierstevens.com/files/software/pdfid_v0_2_1.zip
    unzip pdfid_v0_2_1.zip