Skip to content
Back to search

ST3GG

All-in-one steganography suite

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/elder-plinius--st3gg/badge.svg)](/listings/elder-plinius--st3gg)

HTML

<a href="/listings/elder-plinius--st3gg"><img src="/api/listings/elder-plinius--st3gg/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install from PyPI

pip install stegg

That's it. Now you have `stegg` in your terminal:

# Encode a secret message
stegg encode image.png "your secret message" -o stego.png

# Decode hidden data
stegg decode stego.png

# Analyze a suspicious file
stegg analyze suspicious.png --full

# SPECTER mode with password
stegg encode image.png "{SPECTER:ENABLED}" -o stego.png

Install with extras

pip install stegg[tui]      # Terminal UI (Textual)
pip install stegg[web]      # Web UI (NiceGUI)
pip install stegg[crypto]   # AES-256-GCM encryption
pip install stegg[mcp]      # MCP server for AI agents
pip install stegg[all]      # Everything

Browser (No Install)

# Just open index.html — that's it. No server needed.
open index.html

Everything runs 100% client-side. No data ever leaves your machine.

From Source

git clone https://github.com/elder-plinius/st3gg.git
cd st3gg
pip install -e ".[all]"

Interfaces

stegg --help          # Interactive CLI (Rich TUI output)
stegg-cli --help      # Agent CLI (JSON output, subprocess-friendly)
stegg-tui             # Terminal UI (requires: pip install stegg[tui])
stegg-web             # Browser UI (requires: pip install stegg[web])
stegg-mcp             # MCP server for AI agents (requires: pip install stegg[mcp])

AI Agent Integration

Two interfaces for AI agents — pick based on context cost needs:

# CLI (subprocess, zero context cost — output stays out of LLM context)
stegg-cli encode -i carrier.png -t "secret" -o stegged.png
stegg-cli decode -i stegged.png
stegg-cli analyze suspect.png --full

# MCP server (stdio transport — results go into agent context)
stegg-mcp  # or: uv run --extra mcp python3 mcp_server.py

See `skills/stegg-cli/` and `skills/stegg-stego/` for harness-agnostic agent skills, and `AGENTS.md` for the quick-reference guide.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 550 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <pre>
  3. ███████╗████████╗██████╗ ██████╗ ██████╗
  4. ██╔════╝╚══██╔══╝╚════██╗██╔════╝ ██╔════╝
  5. ███████╗ ██║ █████╔╝██║ ███╗██║ ███╗
  6. ╚════██║ ██║ ╚═══██╗██║ ██║██║ ██║
  7. ███████║ ██║ ██████╔╝╚██████╔╝╚██████╔╝
  8. ╚══════╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═════╝
  9. </pre>
  10. </p>
  11. <div align="center">
  12. <!-- ⊰ If you can read this, you understand steganography. The real flag is in the banner image. Decode it with ST3GG. ST3GG{s0urc3_v13w3r} LOVE PLINY ⊱ -->
  13. ### ⊰•-•✧ THE ULTIMATE STEGANOGRAPHY TOOLKIT ✧•-•⊱
  14. **Hide anything. In any file. Across every modality. Undetected.**
  15. 👉 **Hosted site: [ste.gg](https://ste.gg)**
  16. [![PyPI](https://img.shields.io/pypi/v/stegg?color=green&label=pip%20install%20stegg)](https://pypi.org/project/stegg/)
  17. [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL_3.0-purple.svg)](https://github.com/elder-plinius/st3gg/blob/main/LICENSE)
  18. [![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://python.org)
  19. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
  20. [![100+ Examples](https://img.shields.io/badge/Examples-100%2B_files-purple.svg)](https://github.com/elder-plinius/st3gg/tree/main/examples)
  21. ```
  22. __ .--.
  23. / '-. .' '.
  24. / .-. | ⊰ ev͏er͏y pi͏x͏el͏ ha͏s a͏ story͏ ⊱ / .--. \
  25. /.' \| you just can't see it | / \ |
  26. // |\ \ | | | |
  27. || | \ | ⊰ LOVE PLINY ⊱ | \ / |
  28. /|| | \ | \ '--' /
  29. / ||__/ \/ '.____..'
  30. ```
  31. </div>
  32. <p align="center">
  33. <img src="examples/st3gg_banner.png" alt="ST3GG Banner" width="600">
  34. <br><sub><i>This image contains hidden data. Can you find it?</i></sub>
  35. </p>
  36. ---
  37. ## ⊰ What Is ST3GG? ⊱
  38. [STE.GG](https://ste.gg)‍​‌​‌​​​​​‌​​‌‌​​​‌​​‌​​‌​‌​​‌‌‌​​‌​‌‌​​‌​​‌​​​​​​‌​​‌‌​​​‌​​‌‌‌‌​‌​‌​‌‌​​‌​​​‌​‌​‌​‌​​‌‌​​‌​​​​​​‌​‌‌​​‌​‌​​‌‌‌‌​‌​‌​‌​‌‍ is a feature-rich, open-source steganography toolkit that hides secret data inside images, audio, documents, network packets, and more — using **100+ encoding techniques** across every file format imaginable.
  39. It runs **100% in your browser** (static site, no server) or as a **Python CLI/TUI/WebUI**. No data ever leaves your machine. Every technique that encodes also decodes. Every attack surface is also a detection surface.
  40. > *⊰•-•✧ Some secrets are hidden in plain sight ✧•-•⊱*
  41. ---
  42. ## ⊰ Why ST3GG? ⊱
  43. | Feature | Other Tools | **ST3GG** |
  44. |---------|-------------|-----------|
  45. | Channel Options | RGB only | **15 presets** (R, G, B, A, RG, RB, RA, GB, GA, BA, RGB, RGA, RBA, GBA, RGBA) |
  46. | Bit Depth | 1 bit fixed | **1-8 bits per channel** (adjustable) |
  47. | Encoding Strategies | Sequential | **4 strategies** (sequential, interleaved, spread, randomized) |
  48. | Nested Steg | - | **Up to 11 layers deep** (Matryoshka mode) |
  49. | Channel Cipher | - | **Novel cross-channel hopping** (SPECTER) |
  50. | Compression Survival | - | **F5 survives JPEG/social media; DCT designed for compression resistance** |
  51. | Smart Decode | - | **120+ config auto-detection** |
  52. | Encryption | Basic/None | **AES-256-GCM + XOR** |
  53. | Image Formats | PNG only | **PNG, JPEG, WebP, GIF** |
  54. | File Types | Images only | **Images, audio, text, docs, network, archives, code** |
  55. | Example Library | None | **100+ pre-encoded example files** |
  56. | Browser-Based | - | **100% client-side JS, no server** |
  57. | AI Agent | - | **Exhaustive AI-powered decoding across all methods** |
  58. ---
  59. ## ⊰ The Big Picture: Offense & Defense ⊱
  60. ST3GG is a **dual-use** toolkit — built for both sides of the steganography battlefield.
  61. ### RED TEAM / Offense — Poisoning Simulations
  62. Data exfiltration doesn't always look like data exfiltration. ST3GG lets red teams and researchers simulate **every known data smuggling vector** to test whether defenses actually catch them:
  63. - **100+ encoding techniques** across images, audio, text, documents, network packets, archives, and code files
  64. - **Polyglot file generation** — files that are simultaneously valid as two formats (PNG+ZIP)
  65. - **Network protocol covert channels** — data hidden in DNS queries, ICMP payloads, TCP sequence numbers, HTTP headers
  66. - **Unicode steganography** — invisible homoglyphs, zero-width chars, variation selectors, confusable whitespace
  67. - **Compression-resistant encoding** — F5 mode operates directly on JPEG coefficients (proven to survive social media); DCT mode designed for compression resistance
  68. - **Multi-layer nesting** — up to 11 recursive layers of steganography (Matryoshka mode)
  69. - **Ghost Mode** — AES-256 encryption + bit scrambling + noise decoys for maximum evasion
  70. *If your DLP can't catch it, you need to know that before the adversary does.*
  71. ### BLUE TEAM / Defense — ALLSIGHT Comprehensive Detection
  72. The same toolkit that creates steganographic payloads also **detects and decodes them**. ST3GG's analysis engine provides full-spectrum visibility across all known data smuggling surfaces:
  73. - **20+ detection functions** — chi-square analysis, bit-plane entropy, histogram analysis, signature scanning, STEG header detection
  74. - **AI-powered exhaustive analysis** — autonomous agent tests every decoding method for the uploaded file type
  75. - **File type identification** — magic byte detection for 20+ formats (PNG, JPEG, GIF, BMP, WebP, TIFF, ICO, SVG, WAV, AIFF, AU, MIDI, PCAP, PDF, ZIP, GZip, TAR, SQLite, and more)
  76. - **Unicode steganography detection** — zero-width chars, homoglyphs, variation selectors, combining marks, confusable whitespace, emoji patterns
  77. - **Whitespace analysis** — trailing space/tab encoding, Unicode space variant detection
  78. - **Metadata forensics** — base64/hex string extraction, EXIF analysis, PNG chunk inspection
  79. - **Network packet analysis** — PCAP parsing for covert channel indicators
  80. - **200+ automated tests** verifying detection accuracy with zero false negatives on known techniques
  81. *See everything. Miss nothing. That's ALLSIGHT.*
  82. > *⊰•-•✧ The best defense starts with understanding the offense ✧•-•⊱*
  83. ---
  84. ## ⊰ Who Is This For? ⊱
  85. ST3GG isn't just a toy. Different communities use steganography tools for very different — and very real — reasons.
  86. ### Penetration Testers & Red Teams
  87. Simulate data exfiltration through steganographic channels during engagements. Test whether endpoint DLP, SIEM rules, and network monitoring catch covert data smuggling across 100+ vectors. Generate adversarial payloads across every file type to validate detection coverage.
  88. ### Blue Teams & SOC Analysts
  89. Use ALLSIGHT to scan suspicious files for hidden payloads. Run exhaustive analysis against every known encoding method. Build detection rules from the comprehensive example library. Train analysts on what steganographic artifacts look like in the wild.
  90. ### CTF Players & Competitive Hackers
  91. The ultimate steg toolkit for Capture The Flag competitions. Encode and decode across every channel/bit/strategy combination. Auto-detect unknown configurations with Smart Scan. Unwrap multi-layered Matryoshka challenges automatically.
  92. ### Digital Forensics & Incident Response
  93. Analyze seized media for steganographic communication channels. Detect hidden data in image attachments, document metadata, audio files, and network captures. Identify which encoding technique was used and extract the hidden payload.
  94. ### Privacy Researchers & Journalists
  95. Explore steganography as a privacy-preserving communication channel. Understand the trade-offs between capacity, stealth, and compression survival. Test which techniques survive social media re-encoding for real-world deniable communication.
  96. ### Academics & Students
  97. Study the full landscape of steganographic techniques across every modality. Use the 100+ example files as a teaching dataset. Benchmark new detection algorithms against known encodings. The codebase is well-documented and AGPL-3.0 licensed — free for individuals, researchers, and open-source projects.
  98. ### AI Safety & LLM Security
  99. Test how AI systems handle steganographic content — hidden instructions in images, invisible Unicode in prompts, polyglot files that bypass content filters. Understand the data smuggling surface area that AI systems need to defend against.
    • Dismissed after review: Tells the agent to set aside its instructions or safety, or to reveal its system prompt: "bypass content filters"
    • Line 138 on GitHub
  100. ### Data Loss Prevention (DLP) Vendors
  101. Benchmark your DLP solution against ST3GG's 100+ encoding techniques. If your product can't detect data hidden in DNS query names, TCP sequence numbers, or invisible Unicode characters — your customers deserve to know. ST3GG is your adversarial test suite.
  102. ### AI Agent Security & Red Teaming
  103. The next frontier of steganography is **agent-to-agent covert communication** and **prompt injection via hidden payloads**. ST3GG is the toolkit for this emerging attack surface:
  104. - **Prompt injection via images** — embed hidden instructions in images that vision-enabled agents process. The agent sees a normal photo; the hidden payload says "ignore all previous instructions."
    • Note: Quotes instruction-override phrasing (in quotes, code, a table or an example): "ignore all previous instructions"
    • Line 146 on GitHub
  105. - **Agent data exfiltration** — test whether your agent can be tricked into encoding stolen data into images it generates, smuggling it past output filters.
  106. - **Covert agent channels** — agents passing hidden instructions through innocuous-looking files in shared tool contexts.
  107. - **Agent output watermarking** — embed provenance or tracking data in images agents generate for attribution.
  108. - **Content filter bypass** — test moderation systems by hiding prohibited content in image payloads that pass automated review.
  109. - **Multi-modal poisoning** — craft images that look normal to humans but contain hidden data that alters agent behavior when processed.
  110. **Use ST3GG as a Python library in your agent pipeline:**
  111. ```python
  112. from steg_core import encode, decode, detect_encoding, StegConfig, get_channel_preset
  113. from analysis_tools import detect_unicode_steg, detect_file_type, TOOL_REGISTRY
  114. from PIL import Image
  115. # Encode a hidden payload into an image
  116. img = Image.open("carrier.png")
  117. config = StegConfig(channels=get_channel_preset("RGB"), bits_per_channel=1)
  118. stego = encode(img, b"hidden agent instructions", config)
  119. stego.save("stego.png")
  120. # Detect and decode hidden data
  121. detected = detect_encoding(Image.open("stego.png"))
  122. if detected:
  123. payload = decode(Image.open("stego.png"))
  124. print(f"Found: {payload.decode()}")
  125. # Scan for ALL steganography types
  126. tools = TOOL_REGISTRY.list_tools() # 48 detection tools
  127. result = detect_unicode_steg(open("message.txt", "rb").read())
  128. if result['found']:
  129. print(f"Hidden Unicode: {result['invisible_chars']} chars")
  130. ```
  131. ---
  132. ## ⊰ Megalithic Features ⊱
  133. ### SPECTER — Channel Cipher Steganography
  134. *A novel approach where data hops between color channels like a cryptographic dance.*
  135. Instead of hiding all data in one channel, SPECTER distributes bits across R, G, and B channels in a pattern that becomes your key:
  136. ```
  137. Pattern: R1-G2-B1-RG2-B1
  138. │ │ │ │ └─ 1 bit in Blue
  139. │ │ │ └───── 2 bits in Red+Green
  140. │ │ └──────── 1 bit in Blue
  141. │ └─────────── 2 bits in Green
  142. └────────────── 1 bit in Red
  143. ```
  144. Two modes: **Manual Pattern** (you define) or **Password Mode** (derived from passphrase + optional encryption). Embed via **LSB** (high capacity) or **DCT** (compression-resistant).
  145. ### Ghost Mode — Maximum Stealth
  146. Triple-layer obfuscation for when the stakes are real:
  147. 1. **AES-256-GCM Encryption** — authenticated, military-grade
  148. 2. **Bit Scrambling** — Fisher-Yates shuffle with seeded PRNG
  149. 3. **50% Noise Decoys** — half the embedded bits are random noise
  150. An attacker would need to know the channel pattern, the password for unscrambling, AND the decryption key. Trade-off: halves capacity.
  151. ### Matryoshka Mode — Recursive Nesting
  152. Hide images within images within images — up to **11 layers deep**. The smart decoder automatically detects PNG magic bytes and recursively unwraps every layer. Russian nesting dolls, but for secrets.
  153. ### DCT Mode — Compression Resistant
  154. Traditional LSB is destroyed by ANY JPEG compression — even quality 99%. DCT mode embeds in frequency-domain coefficients of 8x8 pixel blocks, designed for compression resistance. For **proven** social media survival, use **F5 mode** which operates directly on JPEG DCT coefficients via matrix encoding.
  155. > **LSB** → PNG only (lossless). **DCT** → compression resistant. **F5** → survives JPEG/social media.
  156. ### AI Agent — Reveal & Conceal
  157. The AI agent has two modes:
  158. **🔍 Reveal** — Upload any file. The agent tests every known decoding method automatically, finds hidden data, and extracts it as downloadable artifacts.
  159. **🔮 Conceal** — Type a secret message, upload (or generate) a carrier image, and the agent hides your data using the optimal encoding method. One click from secret to stego image.
  160. Powered by OpenRouter. Works with Claude, GPT, Gemini, and other models.
  161. ---
  162. ## ⊰ 100+ Steganographic Techniques ⊱
  163. ST3GG doesn't just hide data in images. It covers **every modality**:
  164. ### Image Techniques
  165. LSB embedding (RGB, RGBA, grayscale) across PNG, BMP, TIFF, GIF, WebP, ICO, PPM, PGM — plus alpha channel LSB, PNG filter-type encoding, palette index manipulation, DCT frequency domain, PNG+ZIP polyglots, metadata injection (EXIF, XMP, tEXt chunks), and trailing data after IEND.
  166. ### Text & Unicode Techniques
  167. Zero-width characters (ZWSP/ZWNJ/ZWJ), invisible ink (Unicode tag chars U+E0000), homoglyph substitution (Cyrillic/Latin), variation selectors, combining diacritics (CGJ), confusable whitespace (en/em/thin/hair spaces), whitespace encoding (space=0/tab=1), emoji substitution, and capitalization encoding.
  168. ### Audio Techniques
  169. Sample LSB in WAV, AIFF, and AU formats. Silence interval timing (gap duration encodes bits). MIDI SysEx message embedding.
  170. ### Network Protocol Techniques
  171. DNS tunneling (base32 in query labels), ICMP payload injection, TCP covert channels (ISN + timestamps), HTTP header smuggling (custom X- headers, cookies).
  172. ### Document & Archive Techniques
  173. PDF (metadata streams + XMP + post-EOF), HTML (comments + hidden elements + data attributes + zero-width), XML (CDATA + PIs + namespaces), JSON (Unicode escapes + key ordering), CSV/YAML/TOML/INI (comment encoding + whitespace), RTF (hidden text groups), Markdown (HTML comments + link references), ZIP/TAR/GZip (comments + extended headers + extra fields), SQLite (hidden tables), and more.
  174. ### Code Techniques
  175. Python, JavaScript, C, CSS, Shell, SQL, LaTeX — all with steganographic comments, hex byte tables, zero-width docstrings, and per-byte calibration entries.
  176. > *⊰•-•✧ See the full catalog: [`examples/README.md`](examples/README.md) ✧•-•⊱*
  177. ---
  178. ## ⊰ Quick Start ⊱
  179. ### Install from PyPI
  180. ```bash
  181. pip install stegg
  182. ```
  183. That's it. Now you have `stegg` in your terminal:
  184. ```bash
  185. # Encode a secret message
  186. stegg encode image.png "your secret message" -o stego.png
  187. # Decode hidden data
  188. stegg decode stego.png
  189. # Analyze a suspicious file
  190. stegg analyze suspicious.png --full
  191. # SPECTER mode with password
  192. stegg encode image.png "{SPECTER:ENABLED}" -o stego.png
  193. ```
  194. ### Install with extras
  195. ```bash
  196. pip install stegg[tui] # Terminal UI (Textual)
  197. pip install stegg[web] # Web UI (NiceGUI)
  198. pip install stegg[crypto] # AES-256-GCM encryption
  199. pip install stegg[mcp] # MCP server for AI agents
  200. pip install stegg[all] # Everything
  201. ```
  202. ### Browser (No Install)
  203. ```bash
  204. # Just open index.html — that's it. No server needed.
  205. open index.html
  206. ```
  207. Everything runs 100% client-side. No data ever leaves your machine.
  208. ### From Source
  209. ```bash
  210. git clone https://github.com/elder-plinius/st3gg.git
  211. cd st3gg
  212. pip install -e ".[all]"
  213. ```
  214. ### Interfaces
  215. ```bash
  216. stegg --help # Interactive CLI (Rich TUI output)
  217. stegg-cli --help # Agent CLI (JSON output, subprocess-friendly)
  218. stegg-tui # Terminal UI (requires: pip install stegg[tui])
  219. stegg-web # Browser UI (requires: pip install stegg[web])
  220. stegg-mcp # MCP server for AI agents (requires: pip install stegg[mcp])
  221. ```
  222. ### AI Agent Integration
  223. Two interfaces for AI agents — pick based on context cost needs:
  224. ```bash
  225. # CLI (subprocess, zero context cost — output stays out of LLM context)
  226. stegg-cli encode -i carrier.png -t "secret" -o stegged.png
  227. stegg-cli decode -i stegged.png
  228. stegg-cli analyze suspect.png --full
  229. # MCP server (stdio transport — results go into agent context)
  230. stegg-mcp # or: uv run --extra mcp python3 mcp_server.py
  231. ```
  232. See `skills/stegg-cli/` and `skills/stegg-stego/` for harness-agnostic agent skills, and `AGENTS.md` for the quick-reference guide.
  233. ---
  234. ## ⊰ Channel & Bit Depth ⊱
  235. ### 15 Channel Presets x 8 Bit Depths = 120 Combinations
  236. | Preset | Stealth | Capacity | Best For |
  237. |--------|---------|----------|----------|
  238. | B (Blue, 1-bit) | Excellent | Low | Maximum invisibility |
  239. | RGB (3-channel, 1-bit) | Very Good | Medium | Balanced |
  240. | RGBA (4-channel, 4-bit) | Moderate | **4MB+** | Large file hiding |
  241. ### 4 Encoding Strategies
  242. | Strategy | Description |
  243. |----------|-------------|
  244. | **Sequential** | Bits placed in pixel order (fastest) |
  245. | **Interleaved** | Alternating pixels across image |
  246. | **Spread** | Distributed evenly across entire image |
  247. | **Randomized** | Pseudo-random placement (seeded PRNG) |
  248. ### Capacity Formula
  249. ```
  250. Capacity = (Width x Height x Channels x BitsPerChannel) / 8 bytes
  251. ```
  252. A 1920x1080 image with RGB 1-bit holds ~760KB. With RGBA 4-bit: **~4MB**.
  253. ---
  254. ## ⊰ Encryption ⊱
  255. | Method | Strength | Speed | Use Case |
  256. |--------|----------|-------|----------|
  257. | **AES-256-GCM** | Maximum | Medium | Ghost Mode |
  258. | **XOR Obfuscation** | Minimal | Fast | Basic scrambling only (not encryption) |
  259. | **None** | - | Fastest | When secrecy isn't needed |
  260. ---
  261. ## ⊰ Example Library ⊱
  262. ST3GG ships with **100+ pre-encoded example files** spanning every technique — images, audio, documents, network captures, code files, and more. Each one contains a hidden message that the analysis tools can find.
  263. ```bash
  264. # Regenerate all examples
  265. python examples/generate_examples.py
  266. # Run the full test suite (200+ tests)
  267. python test_examples.py
  268. ```
  269. See [`examples/README.md`](examples/README.md) for the full catalog.
  270. ---
  271. ## ⊰ Project Structure ⊱
  272. ```
  273. ST3GG/
  274. ├── index.html # Browser UI (100% client-side)
  275. ├── steg_core.py # Core LSB encoding/decoding engine
  276. ├── crypto.py # AES-256-GCM + XOR encryption
  277. ├── analysis_tools.py # 20+ detection & analysis functions
  278. ├── cli.py # Command-line interface
  279. ├── tui.py # Terminal UI (Textual)
  280. ├── webui.py # Web UI (NiceGUI)
  281. ├── app.py # Core application logic
  282. ├── injector.py # Metadata & filename injection
  283. ├── ascii_art.py # Terminal art & animations
  284. ├── f5stego-lib.js # F5 JPEG steganography (browser)
  285. ├── test_examples.py # Test suite (200+ tests)
  286. ├── examples/ # 100+ pre-encoded example files
  287. │ ├── generate_examples.py
  288. │ └── README.md
  289. ├── requirements.txt
  290. └── pyproject.toml
  291. ```
  292. ---
  293. ## ⊰ Security Notes ⊱
  294. - Standard LSB steganography is **statistically detectable** — chi-square and bit-plane analysis can reveal it
  295. - **SPECTER Channel Cipher** increases resistance by hopping across channels unpredictably
  296. - **Ghost Mode** adds encryption + scrambling + noise for maximum stealth
  297. - **DCT mode** designed for compression resistance; **F5 mode** proven to survive JPEG recompression
  298. - **LSB** is destroyed by ANY JPEG compression — use PNG format only
  299. - Always **encrypt** sensitive data before embedding
  300. - For maximum security: **Ghost Mode + DCT + strong password**
  301. ---
  302. ## ⊰ Roadmap ⊱
  303. ```
  304. ╔══════════════════════════════════════════════════════════════════╗
  305. ║ ST3GG EVOLUTION ROADMAP ║
  306. ╠══════════════════════════════════════════════════════════════════╣
  307. ║ ║
  308. ║ ✅ SHIPPED ║
  309. ║ ──────── ║
  310. ║ ✓ 112 steganographic techniques across all modalities ║
  311. ║ ✓ 15 channel presets × 8 bit depths = 120 LSB combinations ║
  312. ║ ✓ 8 encoding methods (LSB, DCT, PVD, F5, Chroma, Palette, ║
  313. ║ Spread Spectrum, SPECTER channel cipher) ║
  314. ║ ✓ AI Agent with Reveal + Conceal modes ║
  315. ║ ✓ 13 text steganography methods with encode + decode ║
  316. ║ ✓ 50 registered analysis/decode tools ║
  317. ║ ✓ RS Analysis + Sample Pairs Analysis (academic steganalysis) ║
  318. ║ ✓ Raw PNG parser (bypasses canvas premultiplied alpha) ║
  319. ║ ✓ Password-derived headers (stealth mode) ║
  320. ║ ✓ AES-256-GCM with PBKDF2 600k iterations ║
  321. ║ ✓ AI carrier image generation (OpenRouter + procedural) ║
  322. ║ ✓ 109 example files, 568 automated tests ║
  323. ║ ✓ pip install stegg ║
  324. ║ ✓ 100% browser-based at ste.gg ║
  325. ║ ║
  326. ║ 🔜 NEXT UP ║
  327. ║ ────────── ║
  328. ║ ○ Spread + Randomized strategies in browser ║
  329. ║ (defined but only interleaved is implemented) ║
  330. ║ ○ Password brute-forcer with wordlist support ║
  331. ║ (Stegseek does 10M/sec — we should match it) ║
  332. ║ ○ Content-adaptive embedding (HUGO/WOW-inspired) ║
  333. ║ (embed in texture, skip smooth areas) ║
  334. ║ ○ Steghide format compatibility ║
  335. ║ (read/write steghide's embedding format) ║
  336. ║ ○ Weighted Stego (WS) analysis ║
  337. ║ (more accurate LSB detection than chi-square) ║
  338. ║ ○ Calibrated RS/SPA for real-world detection accuracy ║
  339. ║ ║
  340. ║ 🔮 FUTURE ║
  341. ║ ────────── ║
  342. ║ ○ ML-based steganalysis ║
  343. ║ (CNN trained on StegoAppDB — Aletheia-grade detection) ║
  344. ║ ○ nsF5 / S-UNIWARD embedding ║
  345. ║ (academic state-of-the-art, minimal detectability) ║
  346. ║ ○ Adversarial steganography ║
  347. ║ (GAN-based embedding that defeats ML detectors) ║
  348. ║ ○ Video steganography (frame-by-frame + temporal) ║
  349. ║ ○ Network protocol live capture + injection ║
  350. ║ (real-time covert channel creation, not just PCAPs) ║
  351. ║ ○ WebAssembly acceleration for browser-side analysis ║
  352. ║ ○ Plugin system for community-contributed techniques ║
  353. ║ ○ Mobile-native app (iOS/Android) ║
  354. ║ ○ VS Code / JetBrains extension for inline text steg ║
  355. ║ ○ MCP server for Claude Code / AI agent integration ║
  356. ║ ║
  357. ║ 🌊 MOONSHOTS ║
  358. ║ ──────────── ║
  359. ║ ○ Quantum-resistant steganographic protocols ║
  360. ║ ○ Blockchain-anchored provenance watermarking ║
  361. ║ ○ Cross-modal steganography (hide audio in images, ║
  362. ║ images in text, text in network traffic) ║
  363. ║ ○ Federated steganalysis (distributed detection network) ║
  364. ║ ○ Self-modifying steganographic payloads ║
  365. ║ ○ Steganographic filesystem (deniable encryption layer) ║
  366. ║ ║
  367. ╚══════════════════════════════════════════════════════════════════╝
  368. ```
  369. > *⊰•-•✧ Want to help build any of these? PRs welcome. ✧•-•⊱*
  370. ---
  371. ## ⊰ Contributing ⊱
  372. PRs are welcome! Whether it's new steganographic techniques, better detection algorithms, or entirely new modalities.
  373. ```bash
  374. # Run the comprehensive test suite (568 tests)
  375. python test_comprehensive.py
  376. # Run example file tests
  377. python test_examples.py
  378. # Regenerate all 109 example files
  379. python examples/generate_examples.py
  380. ```
  381. Areas we'd especially love contributions in:
  382. - **ML steganalysis** — train detection models on stego datasets
  383. - **New encoding methods** — academic techniques (HUGO, WOW, HILL, UNIWARD)
  384. - **Format support** — HEIC, AVIF, FLAC, MP4 steganography
  385. - **Steghide compatibility** — read/write steghide's format natively
  386. - **Performance** — WebAssembly for browser-side analysis
  387. - **Mobile** — responsive improvements, native app wrappers
  388. ---
  389. ## ⊰ License ⊱
  390. **AGPL-3.0** — free and open source for individuals, researchers, educators, and open-source projects. See [LICENSE](LICENSE) for details.
  391. **Enterprise / Commercial use?** If you want to use ST3GG in a proprietary product or SaaS without open-sourcing your code, contact us for a commercial license.
  392. This tool is intended for **authorized security research**, **CTF competitions**, **digital forensics education**, and **privacy research**. Use responsibly.
  393. ---
  394. <div align="center">
  395. ```
  396. ⊰•-•✧•-•-⦑ ST3GG ⦒-•-•✧•-•⊱
  397. every pixel has a story
  398. you just can't see it
  399. 🦕︁
  400. ```
  401. *⊰ hidden in plain sight ⊱*
  402. </div>
  403. [//]: # (⊰ ST3GG{r34dm3_h4ck3r} - you found the hidden link reference! The Plinian divider lives in all things. LOVE PLINY ⊱)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.