🔐 CryptoStego

Steganography Toolkit — Hide secret messages and files inside images using LSB encoding with optional XOR encryption.

🔥 Features

• 🖼️ LSB Steganography — Hide data in the least significant bits of image pixels
• 🔑 XOR Encryption — Optional password-based encryption with SHA-256 key stretching
• 📊 Stego Analysis — Detect hidden data via LSB statistical analysis
• 📁 File Embedding — Hide any file type (documents, archives, executables)
• 🎯 BMP Native Support — Zero dependencies for BMP images
• 🖼️ PNG/JPEG Support — Via optional Pillow dependency
• 💾 Capacity Calculator — Check how much data an image can hold

🚀 Installation

```bash git clone https://github.com/redX000/CryptoStego.git cd CryptoStego pip install -e .

For PNG/JPEG support:

pip install Pillow ```

📖 Usage

Hide a message

```bash cryptostego hide cover.bmp -m "Secret message here" -o stego.bmp cryptostego hide photo.png -m "Encrypted!" -p mypassword -o output.png ```

Hide a file

```bash cryptostego hide cover.bmp -f secret.zip -o stego.bmp cryptostego hide cover.png -f passwords.txt -p strongpass -o output.png ```

Extract hidden data

```bash cryptostego extract stego.bmp cryptostego extract stego.bmp -p mypassword cryptostego extract stego.bmp -o extracted_file.zip ```

Check capacity

```bash cryptostego capacity image.bmp ```

Analyze image

```bash cryptostego analyze suspicious_image.png ```

🧠 How It Works

1. Encoding: Each bit of the secret payload replaces the LSB of each pixel byte
2. Header: A 12-byte header (magic + flags + length) precedes the payload
3. Encryption: Optional XOR cipher with SHA-256 derived key
4. Detection: Statistical analysis of LSB distribution reveals anomalies

⚠️ Disclaimer

For educational and authorized use only. The author is not responsible for any misuse.

📄 License

MIT License — see LICENSE

👤 Author

Yassine Lasraoui — @redX000