Git Product home page Git Product logo

imago-forensics's Introduction

forthebadge forthebadge

Build Status Requirements Status GitHub license

imago-forensics ๐Ÿ•ต๏ธ

Imago is a python tool that extract digital evidences from images recursively. This tool is useful throughout a digital forensic investigation. If you need to extract digital evidences and you have a lot of images, through this tool you will be able to compare them easily. Imago allows to extract the evidences into a CSV file or in a sqlite database. If in a JPEG exif are present GPS coordinates, Imago can extract the longitude and latitude and it can convert them to degrees and to retrieve relevant information like city, nation, zip code... Imago offers also the possibility to calculate Error Level Analysis, and to detect nudity these functionalities are in BETA.

Setup

Setup via pip

  1. Install imago:
$ pip install imago
  1. Once installed, one new binary should be available: :
$ imago 

And then it should output the imago's banner

Requirements:

python 2.7
exifread 2.1.2
python-magic 0.4.15
argparse 1.4.0
pillow 5.2.0
nudepy 0.4
imagehash 4.0
geopy 1.16.0

Usage

usage: imago.py [-h] -i INPUT [-x] [-g] [-e] [-n] [-d {md5,sha256,sha512,all}]
                [-p {ahash,phash,dhash,whash,all}] [-o OUTPUT] [-s]
                [-t {jpeg,tiff}]

optional arguments:
  -h, --help            show this help message and exit
  -i INPUT, --input INPUT
                        Input directory path
  -x, --exif            Extract exif metadata
  -g, --gps             Extract, parse and convert to coordinates, GPS exif
                        metadata from images (if any)It works only with JPEG.
  -e, --ela             Extract, Error Level Analysis image,It works only with
                        JPEG. *BETA*
  -n, --nude            Detect Nudity, It works only with JPEG, *BETA*
  -d {md5,sha256,sha512,all}, --digest {md5,sha256,sha512,all}
                        Calculate perceptual image hashing
  -p {ahash,phash,dhash,whash,all}, --percentualhash {ahash,phash,dhash,whash,all}
                        Calculate hash digest
  -o OUTPUT, --output OUTPUT
                        Output directory path
  -s, --sqli            Keep SQLite file after the computation
  -t {jpeg,tiff}, --type {jpeg,tiff}
                        Select the image, this flag can be JPEG or TIFF, if
                        this argument it is not provided, imago will process
                        all the image types(i.e. JPEG, TIFF)



The only required argument is -i which is the base directory from which imago will start to search for image file. You should also provide at least one type of extraction (i.e. exif, data, gps, digest).

Example:

$ imago -i /home/solvent/cases/c23/DCIM/ -o /home/solvent/cases/c23/ -x -s -t jpeg -d all

Where:

  • -i path: is the base directory, where imago will search for file
  • -o path: the output directory where imago will save the CSV file, with the extracted metadata
  • -x : imago will extract EXIF metadata.
  • -s: the temporary SQLite database will not be deleted after the processing.
  • -t jpeg: imago will search only for jpeg images.
  • -d all: imago will calculate md5, sha256, sha512 for the jpeg images.

Features:

Functionality Status
Recursive directory navigation โœ”๏ธ
file mtime (UTC) โœ”๏ธ
file ctime (UTC) โœ”๏ธ
file atime (UTC) โœ”๏ธ
file size (bytes) โœ”๏ธ
MIME type โœ”๏ธ
Exif support โœ”๏ธ
CSV export โœ”๏ธ
Sqlite export โœ”๏ธ
md5, sha256, sha512 โœ”๏ธ
Error Level Analysis โœ”๏ธ BETA
Full GPS support โœ”๏ธ
Nudity detection โœ”๏ธ BETA
Perceptual Image Hashing โœ”๏ธ
aHash โœ”๏ธ
pHash โœ”๏ธ
dHash โœ”๏ธ
wHash โœ”๏ธ

ToDo:

Task Status
Test code โŒ
Comments and Suggestions are welcome ๐Ÿ‘

๐Ÿ“‘ Copyright and Licenses

Code copyright 2018 Redaelli. Code released under the MIT license.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.