stegofox

StegoFox Pro 🦊

High-performance encrypted steganography CLI.

More about me / other projects: abhrankan.netlify.app

Hide any file inside a PNG image using LSB (least-significant-bit) embedding, optionally encrypted with AES-256-GCM before it ever touches the pixels.

Features

Install

pip install stegofox

Or from source:

git clone https://github.com/foxhackerzdevs/stegofox.git
cd stegofox
pip install -e .

Usage

stegofox embed cover.png secret.txt -o output.png
# With password protection -- omit the value to be prompted (recommended)
stegofox embed cover.png secret.txt -o output.png --password
# Password:
🦊 StegoFox Pro

πŸ“Έ Loading cover image: cover.png
πŸ“ Image capacity: ~2,400 bytes
πŸ” Encrypting payload...
🧬 Embedding 712 bits...
βœ… Successfully embedded! Saved to output.png
stegofox extract output.png --password
# Password:
🦊 StegoFox Pro

πŸ” Analyzing output.png
πŸ”“ Decrypting...
βœ… Extracted 33 bytes
checking output messages exactly
# Wrong password fails cleanly, no crash
stegofox extract output.png --password
# Password: (wrong password entered)
🦊 StegoFox Pro

πŸ” Analyzing output.png
πŸ”“ Decrypting...
❌ Decryption failed. Wrong password?

--password <value> (passing it directly) is also accepted for scripted use, but prints a warning to stderr β€” the password is visible in shell history and to other local users via ps. Prefer the prompted form above for interactive use.

How it works

Each RGB channel byte of the cover image has its least-significant bit replaced with one bit of the payload. A 4-byte magic signature (SFOX) plus a 4-byte length header precede the payload so extraction knows exactly how much data to read back out. Output is always saved as PNG β€” a lossy format (JPEG, etc.) would destroy the embedded bits on save.

With --password, the payload is encrypted with AES-256-GCM (authenticated encryption) before embedding, so a wrong password fails the auth-tag check and returns a clean error rather than garbage bytes.

Security Notes

Requirements

Python >= 3.8, pillow, numpy, pycryptodome.

License

MIT