Skip to main content

Universal steganographic analysis — statistical, forensic, and neural watermark detection

Project description

Stegmarc

Universal steganographic analysis — statistical, forensic, and neural watermark detection.

Install

pip install stegmarc                  # statistical + forensic detectors
pip install "stegmarc[neural]"        # + TrustMark / Stable Signature neural detection

Usage

from stegmarc import analyze, robustness_test

# Analyze any image
result = analyze("image.jpg")
print(result.verdict)
print(result.confidence)
result.save_report("audit.pdf")

# Test watermark robustness
report = robustness_test("cover.jpg", secret="my_id")
print(f"Survived {report.survival_rate:.0%} of attacks")
print(f"Failed: {report.failed_attacks}")
report.save_report("robustness_audit.pdf")

# With cover image for quality metrics
result = analyze("stego.jpg", cover_path="original.jpg")
print(f"PSNR: {result.psnr:.1f} dB  SSIM: {result.ssim:.4f}")

What it detects

Detector Domain Catches
Chi-square JPEG DCT LSB replacement in DCT coefficients
RS Analysis Spatial Pixel-level LSB substitution
SPA Spatial Sample pair analysis
EOF Detection Forensic Data appended after image end marker
EXIF Analysis Forensic Metadata anomalies, steg tool fingerprints
LSB Histogram Forensic LSB plane uniformity
Multi-channel Forensic Per-R/G/B channel embedding
TrustMark Neural Adobe C2PA robust watermarks
Stable Signature Neural Meta AI Stable Diffusion watermarks
SRNet Neural/GPU Adaptive spatial steg (WOW/S-UNIWARD/HILL)

API

Also available as a hosted API: https://raghav7006--stegmark-api-web.modal.run

curl -X POST https://raghav7006--stegmark-api-web.modal.run/analyze \
  -F "stego=@image.jpg"

Installation Notes

Apple Silicon (M1/M2/M3 Mac)

jpegio requires a native arm64 build:

ARCHFLAGS="-arch arm64" pip install jpegio
pip install stegmarc

Linux

pip install stegmarc

Windows

jpegio is not supported on Windows. Use WSL2 or Docker.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stegmarc-1.0.1.tar.gz (31.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stegmarc-1.0.1-py3-none-any.whl (34.9 kB view details)

Uploaded Python 3

File details

Details for the file stegmarc-1.0.1.tar.gz.

File metadata

  • Download URL: stegmarc-1.0.1.tar.gz
  • Upload date:
  • Size: 31.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for stegmarc-1.0.1.tar.gz
Algorithm Hash digest
SHA256 49f8d615dcab18bfdd3bd594749a3d32b7fea5c835162d35457d1b308502dbcd
MD5 d39ea2c915aec6d81f135f3b71a4e22a
BLAKE2b-256 e3c9affa05cd2af8876ef29658e76bc94399dd564d983d769f94ec2699833fcd

See more details on using hashes here.

File details

Details for the file stegmarc-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: stegmarc-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 34.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for stegmarc-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ba7028288ae228de569d8eca8f933d1327c5a3de18b5e043e843a78be6a084a5
MD5 b7c7950b8ed60d9a7a180f5239418914
BLAKE2b-256 ccfe43c25398e833eceece85a9c416a7665da9501af1ab2c9fa1c1b65869ecd9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page