pixhash 1.0.0

CTI tool to extract and hash images from websites

Pixhash

Pixhash is a simple Cyber Threat Intelligence (CTI) tool that extracts all images from a webpage (including those referenced in CSS) and calculate their hashes.

Disclaimer

Pixhash is provided solely for legitimate security research, threat intelligence, and defensive purposes. The author and contributors are not responsible for any damage, legal liability, or other consequences arising from improper or malicious use of this tool.

Installation

Install from PyPI:

pip install pixhash

Or install directly from Github:

pip install git+https://github.com/fwalbuloushi/pixhash.git

Usage

After installation, the pixhash command is available:

pixhash [OPTIONS] URL

Options

Flag	Description
-t, --timeout TIMEOUT	Network timeout in seconds (default: 10.0)
--algo {sha256,sha1,md5}	Hash algorithm to use (default: sha256)
--agent {desktop,mobile}	User-Agent type (default: desktop)
--delay DELAY	Seconds to wait between each HTTP request (default: 0)
-h, --help	Show this help message

Examples

Basic usage with default settings:

pixhash https://example.com

Set a 5-second timeout and use MD5:

pixhash https://example.com -t 5 --algo md5

Slow down requests by 2 seconds and pretend to be a mobile browser:

pixhash https://example.com --delay 2 --agent mobile

[!IMPORTANT] If your URL’s query string uses the & separator, wrap it in single quotes so your shell doesn’t treat & as the background operator.

pixhash 'https://example.com/page?foo=1&bar=2' --delay 5

How it works

1. Fetches the HTML of the page you specify.

2. Parses all , tags, CSS url(...) references (inline & external), Open Graph images, and icons.

3. Downloads each resource (respecting your timeout and delay).

4. Hashes the raw image bytes using your chosen algorithm.

5. Prints each image’s full URL and its calculated hash.

License

This project is licensed under the MIT License.