v0.1.0

lowkey v0.1.0

LSB steganography tool for hiding encrypted messages in PNG images.

Features

• ChaCha20-Poly1305 encryption: All messages are encrypted with AEAD
• Customizable keys: Use your own password (any length, SHA256-hashed)
• Multi-image support: Split large messages across multiple images
• PNG metadata preservation: Maintains ICC profiles and other metadata
• Auto-resize: Automatically resize images to fit messages
• Unicode support: Keys can include emoji and international characters

Installation

Download the appropriate binary for your system and make it executable:

# Linux x86_64
chmod +x lowkey-linux-x86_64
sudo mv lowkey-linux-x86_64 /usr/local/bin/lowkey

# macOS
chmod +x lowkey-macos-aarch64  # or lowkey-macos-x86_64 for Intel
sudo mv lowkey-macos-aarch64 /usr/local/bin/lowkey

# Windows - just rename and run

Quick Start

# Encode with default key
lowkey encode --image input.jpg --message message.txt --output encoded.png

# Decode with default key
lowkey decode --image encoded.png --output decoded.txt

# Use custom encryption key
lowkey encode --image input.jpg --message message.txt --output encoded.png --key "my-secret-password🔐"
lowkey decode --image encoded.png --output decoded.txt --key "my-secret-password🔐"

# Multi-image encoding
lowkey encode --image-list img1.jpg img2.png --message large.txt --output-dir ./output
lowkey decode --image-dir ./output --output decoded.txt

# Auto-resize if message is too large
lowkey encode --image small.jpg --message big.txt --output output.png --auto-resize

Important Notes

• Output must be PNG: JPEG output is not supported due to lossy compression
• Remember your key: Without the correct encryption key, messages cannot be recovered
• Unicode keys supported: You can use emoji and international characters in your password

Supported Platforms

• Linux x86_64 (statically linked with musl)
• Linux ARM64 (statically linked with musl)
• Windows x86_64
• macOS Intel (x86_64)
• macOS Apple Silicon (ARM64)