imagestego 2.0.0

Multimedia Obfuscation & Steganography Toolkit

ImageStego

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

Features

Obfuscation (Image / GIF / MP4)

Algorithm	Description
Pixel Scramble	Pseudo-random pixel permutation
Block Scramble	Block-level shuffling
Arnold Cat Map	Classic chaotic map transform
Baker's Map	Baker's map + optional XOR encryption
Henon Map	Henon chaotic system
Logistic Map	Logistic chaotic sequence
DNA Encoding	DNA-based pixel encoding
Spiral Scan	Spiral-order pixel rearrangement

Steganography

Method	Description
LSB	Least Significant Bit embedding
LSB Edge	Randomized LSB with edge detection
DCT	Frequency-domain (DCT coefficient) embedding
DWT	Wavelet-domain (Haar DWT) embedding
PVD	Pixel Value Differencing
Spread Spectrum	QIM-based spread spectrum

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