ImageStego

Multimedia Obfuscation & Steganography Toolkit — a Python library for image/video obfuscation and message hiding.

Features

Obfuscation (Image / GIF / MP4)

Steganography

All steganography methods support Fernet encryption (password-protected) and timestamp embedding.

Installation

pip install imagestego

Optional dependencies:

pip install imagestego[gui]       # Web GUI (PyWebIO)
pip install imagestego[progress]  # Progress bars (tqdm)

Quick Start

Obfuscation

from imagestego import pixel_obfuscate, pixel_deobfuscate

# Encrypt
pixel_obfuscate("input.png", "encrypted.png", seed=42)

# Decrypt
pixel_deobfuscate("encrypted.png", "restored.png", seed=42)

Multi-layer Pipeline

from imagestego import ObfuscationPipeline

pipeline = ObfuscationPipeline()
pipeline.add_layer("arnold", iterations=30)
pipeline.add_layer("bakers", iterations=10, password="secret")
pipeline.add_layer("dna")

sidecar = pipeline.encrypt("input.png", "output.png")
# Generates output.png + output.layers.json

pipeline.decrypt("output.png", "restored.png")

Steganography

from imagestego import lsb_embed_message, lsb_extract_message

# Hide a message
lsb_embed_message("cover.png", "Hello World", "stego.png", password="key123")

# Extract
result = lsb_extract_message("stego.png", password="key123")
print(result["message"])

Batch Processing

from imagestego.batch_processor import batch_obfuscate

result = batch_obfuscate(
    input_dir="./images",
    output_dir="./output",
    method="arnold",
    params={"iterations": 20},
    max_workers=4,
)
print(result)  # Total=10, Success=10, Failed=0

CLI

imagestego          # Interactive CLI
imagestego-gui      # Web GUI (requires pywebio)

Requirements

• Python >= 3.9
• numpy, Pillow, cryptography, scipy, moviepy

License

MIT