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.
pip install stegofox
Or from source:
git clone https://github.com/foxhackerzdevs/stegofox.git
cd stegofox
pip install -e .
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.
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.
--password never touches CLI args when used interactively β omit the value to be prompted via getpass. The --password <value> form is still accepted for scripts, but leaks the password into shell history and ps.Python >= 3.8, pillow, numpy, pycryptodome.
MIT