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--stegmarc-api-web.modal.run

curl -X POST https://raghav7006--stegmarc-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.3.tar.gz (28.5 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.3-py3-none-any.whl (32.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: stegmarc-1.0.3.tar.gz
  • Upload date:
  • Size: 28.5 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.3.tar.gz
Algorithm Hash digest
SHA256 ffc8b6637eb655b24fa8bca7bb0fecd54f16952e70179d69f8afd56775b35ec0
MD5 68b751834f8b8b32d6212ef0fca981bf
BLAKE2b-256 b7286b4a3e2aa36ba1951a8552a15d916205396a42872afa3bb3fdcbeb01859c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: stegmarc-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 32.4 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 2de2ddb5d850281c2409ad4053aa3f6fbda963ec3ae0bfd060764be7927955b2
MD5 ecab47490aab27b8c17156d07e1090ef
BLAKE2b-256 a81d00ebac4222b1227cfd3de7a883bfab1652b559d86f157a816de917d8642b

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