HashGrid is a simple CLI tool for generating and decoding color grid images based on the cryptographic hash of a file. The resulting image serves as a visual fingerprint of the file and can be used to verify file identity or integrity.
- Generate a visually unique, decodable color grid image from any file
- Decode a previously generated image back into its hash
- Uses colorful, reversible encoding (each hex digit maps to a unique color)
pip install -r requirements.txtRequirements:
- Python 3.8+
- Pillow
- Typer
- Rich
python main.py generate path/to/your/file.ext --output hash_grid.pngThis will:
- Hash the file using SHAKE-256
- Convert the hex string into colors
- Generate and display a color grid image
- Save the image to
hash_grid.png(or your provided filename)
python main.py decode path/to/hash_grid.pngThis will:
- Load the image
- Read colors in the grid
- Convert them back into the original hash string
python main.py generate example.txt --output myfile_hash.png
python main.py decode myfile_hash.png- By default, the hash is 450 bytes (hex string of 900 characters)
- The grid will be approximately square based on the hash length
- This tool supports any file format
MIT License