</div>

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/121/96f422606110041227c4c4a5a6dfa138bbb5ae0a7443ff02bde46bf1ee2d548d.png" alt="Bannière ST3GG" width="600">
<br><sub><i>Cette image contient des données cachées. Pouvez-vous les trouver ?</i></sub>
</p>

---

## ⊰ Qu'est-ce que ST3GG ? ⊱

[STE.GG](https://ste.gg)‍​‌​‌​​​​​‌​​‌‌​​​‌​​‌​​‌​‌​​‌‌‌​​‌​‌‌​​‌​​‌​​​​​​‌​​‌‌​​​‌​​‌‌‌‌​‌​‌​‌‌​​‌​​​‌​‌​‌​‌​​‌‌​​‌​​​​​​‌​‌‌​​‌​‌​​‌‌‌‌​‌​‌​‌​‌‍ est une boîte à outils de stéganographie open-source riche en fonctionnalités qui cache des données secrètes dans des images, de l'audio, des documents, des paquets réseau, et plus encore — en utilisant **plus de 100 techniques de codage** dans tous les formats de fichiers imaginables.

Il fonctionne **100 % dans votre navigateur** (site statique, pas de serveur) ou en tant que **CLI/TUI/WebUI Python**. Aucune donnée ne quitte jamais votre machine. Chaque technique qui code décode également. Chaque surface d'attaque est aussi une surface de détection.

> *⊰•-•✧ Certains secrets sont cachés à la vue de tous ✧•-•⊱*

---

## ⊰ Pourquoi ST3GG ? ⊱

| Fonctionnalité | Autres outils | **ST3GG** |
|---------|-------------|-----------|
| Options de canal | RGB uniquement | **15 préréglages** (R, G, B, A, RG, RB, RA, GB, GA, BA, RGB, RGA, RBA, GBA, RGBA) |
| Profondeur de bits | 1 bit fixe | **1-8 bits par canal** (ajustable) |
| Stratégies de codage | Séquentiel | **4 stratégies** (séquentielle, entrelacée, dispersée, aléatoire) |
| Stéganographie imbriquée | - | **Jusqu'à 11 couches de profondeur** (mode Matriochka) |
| Chiffrement de canal | - | **Saut inter-canaux innovant** (SPECTER) |
| Résistance à la compression | - | **F5 survit au JPEG/réseaux sociaux ; DCT conçu pour la résistance à la compression** |
| Décodage intelligent | - | **Détection automatique de 120+ configurations** |
| Chiffrement | Basique/Aucun | **AES-256-GCM + XOR** |
| Formats d'image | PNG uniquement | **PNG, JPEG, WebP, GIF** |
| Types de fichiers | Images uniquement | **Images, audio, texte, docs, réseau, archives, code** |
| Bibliothèque d'exemples | Aucune | **100+ fichiers exemples pré-codés** |
| Basé navigateur | - | **100 % côté client JS, pas de serveur** |
| Agent IA | - | **Décodage exhaustif alimenté par l'IA sur toutes les méthodes** |

---

## ⊰ La Grande Image : Attaque et Défense ⊱

ST3GG est une boîte à outils à **double usage** — conçue pour les deux côtés du champ de bataille de la stéganographie.

### RED TEAM / Attaque — Simulations d'empoisonnement

L'exfiltration de données ne ressemble pas toujours à une exfiltration de données. ST3GG permet aux red teams et aux chercheurs de simuler **tous les vecteurs de contrebande de données connus** pour tester si les défenses les attrapent réellement :

- **Plus de 100 techniques de codage** dans les images, l'audio, le texte, les documents, les paquets réseau, les archives et les fichiers de code
- **Génération de fichiers polyglottes** — fichiers valides simultanément comme deux formats (PNG+ZIP)
- **Canaux cachés de protocole réseau** — données cachées dans les requêtes DNS, les charges utiles ICMP, les numéros de séquence TCP, les en-têtes HTTP
- **Stéganographie Unicode** — homoglyphes invisibles, caractères de largeur nulle, sélecteurs de variante, espaces confondants
- **Codage résistant à la compression** — le mode F5 opère directement sur les coefficients JPEG (prouvé pour survivre aux réseaux sociaux) ; le mode DCT conçu pour la résistance à la compression
- **Emboîtement multicouche** — jusqu'à 11 couches récursives de stéganographie (mode Matriochka)
- **Mode Fantôme** — chiffrement AES-256 + brouillage de bits + leurres de bruit pour une évasion maximale

*Si votre DLP ne peut pas l'attraper, vous devez le savoir avant que l'adversaire ne le fasse.*

### BLUE TEAM / Défense — Détection Complète ALLSIGHT

La même boîte à outils qui crée des charges utiles stéganographiques les **détecte et les décode** également. Le moteur d'analyse de ST3GG offre une visibilité complète sur toutes les surfaces connues de contrebande de données :

- **Plus de 20 fonctions de détection** — analyse du chi-carré, entropie des plans de bits, analyse d'histogramme, analyse de signature, détection d'en-tête STEG
- **Analyse exhaustive alimentée par l'IA** — agent autonome teste chaque méthode de décodage pour le type de fichier téléchargé
- **Identification du type de fichier** — détection des octets magiques pour plus de 20 formats (PNG, JPEG, GIF, BMP, WebP, TIFF, ICO, SVG, WAV, AIFF, AU, MIDI, PCAP, PDF, ZIP, GZip, TAR, SQLite, et plus)
- **Détection de stéganographie Unicode** — caractères de largeur nulle, homoglyphes, sélecteurs de variante, marques de combinaison, espaces confondants, motifs d'emoji
- **Analyse des espaces** — codage espace/tabulation en fin de ligne, détection de variantes d'espace Unicode
- **Forensic des métadonnées** — extraction de chaînes base64/hex, analyse EXIF, inspection des morceaux PNG
- **Analyse de paquets réseau** — analyse PCAP pour les indicateurs de canaux cachés
- **Plus de 200 tests automatisés** vérifiant la précision de la détection avec zéro faux négatif sur les techniques connues

*Tout voir. Ne rien manquer. C'est ALLSIGHT.*

> *⊰•-•✧ La meilleure défense commence par comprendre l'attaque ✧•-•⊱*

---

## ⊰ À qui s'adresse cet outil ? ⊱

ST3GG n'est pas qu'un jouet. Différentes communautés utilisent des outils de stéganographie pour des raisons très différentes — et très réelles.

### Testeurs de pénétration et Red Teams
Simulez l'exfiltration de données via des canaux stéganographiques lors d'engagements. Testez si la DLP des endpoints, les règles SIEM et la surveillance réseau attrapent la contrebande de données cachée à travers plus de 100 vecteurs. Générez des charges utiles adverses sur tous les types de fichiers pour valider la couverture de détection.

### Blue Teams et analystes SOC
Utilisez ALLSIGHT pour analyser les fichiers suspects à la recherche de charges utiles cachées. Exécutez une analyse exhaustive contre chaque méthode de codage connue. Construisez des règles de détection à partir de la bibliothèque d'exemples complète. Formez les analystes sur l'apparence des artefacts stéganographiques dans la nature.

### Joueurs de CTF et hackers compétitifs
La boîte à outils de stéganographie ultime pour les compétitions Capture The Flag. Codez et décodez sur toutes les combinaisons de canal/bit/stratégie. Détectez automatiquement les configurations inconnues avec Smart Scan. Déballez automatiquement les défis Matriochka multicouches.

### Forensic numérique et réponse aux incidents
Analysez les supports saisis pour les canaux de communication stéganographiques. Détectez les données cachées dans les pièces jointes d'images, les métadonnées de documents, les fichiers audio et les captures réseau. Identifiez la technique de codage utilisée et extrayez la charge utile cachée.

### Chercheurs en vie privée et journalistes
Explorez la stéganographie comme canal de communication préservant la vie privée. Comprenez les compromis entre capacité, discrétion et résistance à la compression. Testez quelles techniques survivent au réencodage des réseaux sociaux pour une communication déniable dans le monde réel.

### Académiciens et étudiants
Étudiez l'ensemble du paysage des techniques de stéganographie à travers toutes les modalités. Utilisez les plus de 100 fichiers d'exemple comme ensemble de données pédagogique. Évaluez de nouveaux algorithmes de détection par rapport aux codages connus. La base de code est bien documentée et sous licence AGPL-3.0 — gratuit pour les particuliers, les chercheurs et les projets open-source.

### Sécurité IA et sécurité des LLM
Testez comment les systèmes d'IA gèrent le contenu stéganographique — instructions cachées dans les images, Unicode invisible dans les invites, fichiers polyglottes qui contournent les filtres de contenu. Comprenez la surface de contrebande de données que les systèmes d'IA doivent défendre.

### Fournisseurs de prévention des pertes de données (DLP)
Évaluez votre solution DLP par rapport aux plus de 100 techniques de codage de ST3GG. Si votre produit ne peut pas détecter les données cachées dans les noms de requête DNS, les numéros de séquence TCP ou les caractères Unicode invisibles — vos clients méritent de le savoir. ST3GG est votre suite de tests adverses.

### Sécurité des agents IA et red teaming
La prochaine frontière de la stéganographie est la **communication cachée agent-à-agent** et l'**injection d'invites via des charges utiles cachées**. ST3GG est la boîte à outils pour cette surface d'attaque émergente :

- **Injection d'invites via des images** — intégrez des instructions cachées dans des images que les agents avec vision traitent. L'agent voit une photo normale ; la charge utile cachée dit « ignorez toutes les instructions précédentes ».
- **Exfiltration de données par l'agent** — testez si votre agent peut être trompé pour coder des données volées dans les images qu'il génère, les faisant passer en contrebande à travers les filtres de sortie.
- **Canaux cachés d'agents** — agents passant des instructions cachées via des fichiers d'apparence inoffensive dans des contextes d'outils partagés.
- **Filigrane de sortie d'agent** — intégrez des données de provenance ou de suivi dans les images que les agents génèrent pour l'attribution.
- **Contournement des filtres de contenu** — testez les systèmes de modération en cachant du contenu interdit dans des charges utiles d'images qui passent la revue automatisée.
- **Empoisonnement multimodal** — créez des images qui semblent normales pour les humains mais contiennent des données cachées qui modifient le comportement de l'agent lorsqu'elles sont traitées.

**Utilisez ST3GG comme bibliothèque Python dans votre pipeline d'agents :**```python
from steg_core import encode, decode, detect_encoding, StegConfig, get_channel_preset
from analysis_tools import detect_unicode_steg, detect_file_type, TOOL_REGISTRY
from PIL import Image

# Encode a hidden payload into an image
img = Image.open("carrier.png")
config = StegConfig(channels=get_channel_preset("RGB"), bits_per_channel=1)
stego = encode(img, b"hidden agent instructions", config)
stego.save("stego.png")

# Detect and decode hidden data
detected = detect_encoding(Image.open("stego.png"))
if detected:
    payload = decode(Image.open("stego.png"))
    print(f"Found: {payload.decode()}")

# Scan for ALL steganography types
tools = TOOL_REGISTRY.list_tools()  # 48 detection tools
result = detect_unicode_steg(open("message.txt", "rb").read())
if result['found']:
    print(f"Hidden Unicode: {result['invisible_chars']} chars")

Deux modes : **Manuel** (vous définissez) ou **Mot de passe** (dérivé de la phrase de passe + chiffrement optionnel). Intégration via **LSB** (haute capacité) ou **DCT** (résistant à la compression).

### Mode Fantôme — Discrétion Maximale

Obfuscation en trois couches pour quand les enjeux sont réels :

1. **Chiffrement AES-256-GCM** — authentifié, de qualité militaire
2. **Brouillage de bits** — mélange de Fisher-Yates avec PRNG ensemencé
3. **50% de leurres sonores** — la moitié des bits intégrés sont du bruit aléatoire

Un attaquant aurait besoin de connaître le motif du canal, le mot de passe pour le débrouillage ET la clé de déchiffrement. Compromis : capacité réduite de moitié.

### Mode Matriochka — Emboîtement Récursif

Cachez des images dans des images dans des images — jusqu'à **11 couches de profondeur**. Le décodeur intelligent détecte automatiquement les octets magiques PNG et déroule récursivement chaque couche. Poupées russes, mais pour les secrets.

### Mode DCT — Résistant à la Compression

Le LSB traditionnel est détruit par TOUTE compression JPEG — même à qualité 99%. Le mode DCT s'intègre dans les coefficients du domaine fréquentiel de blocs de pixels 8x8, conçu pour résister à la compression. Pour une survie **prouvée** sur les réseaux sociaux, utilisez le **mode F5** qui opère directement sur les coefficients DCT JPEG via un codage matriciel.

> **LSB** → PNG uniquement (sans perte). **DCT** → résistant à la compression. **F5** → survit JPEG/réseaux sociaux.

### Agent IA — Révéler & Cacher

L'agent IA a deux modes :

**🔍 Révéler** — Téléchargez n'importe quel fichier. L'agent teste automatiquement toutes les méthodes de décodage connues, trouve les données cachées et les extrait sous forme d'artefacts téléchargeables.

**🔮 Cacher** — Tapez un message secret, téléchargez (ou générez) une image porteuse, et l'agent cache vos données en utilisant la méthode de codage optimale. Un clic du secret à l'image stéganographiée.

Propulsé par OpenRouter. Fonctionne avec Claude, GPT, Gemini et d'autres modèles.

---

## ⊰ 100+ Techniques Stéganographiques ⊱

ST3GG ne cache pas seulement des données dans les images. Il couvre **toutes les modalités** :

### Techniques d'Image
Intégration LSB (RGB, RGBA, niveaux de gris) dans PNG, BMP, TIFF, GIF, WebP, ICO, PPM, PGM — plus LSB du canal alpha, codage par type de filtre PNG, manipulation d'index de palette, domaine fréquentiel DCT, polyglottes PNG+ZIP, injection de métadonnées (EXIF, XMP, chunks tEXt), et données résiduelles après IEND.

### Techniques de Texte & Unicode
Caractères de largeur nulle (ZWSP/ZWNJ/ZWJ), encre invisible (caractères de balisage Unicode U+E0000), substitution d'homoglyphes (cyrillique/latin), sélecteurs de variation, diacritiques combinants (CGJ), espaces confondables (espaces en/em/fins/cheveux), codage par espaces (espace=0/tab=1), substitution d'émojis, et codage par capitalisation.

### Techniques Audio
Échantillonnage LSB dans les formats WAV, AIFF et AU. Synchronisation des intervalles de silence (la durée du silence code les bits). Intégration de messages SysEx MIDI.

### Techniques de Protocole Réseau
Tunnel DNS (base32 dans les labels de requête), injection de charge utile ICMP, canaux cachés TCP (ISN + horodatages), contrebande d'en-têtes HTTP (en-têtes X- personnalisés, cookies).

### Techniques de Documents & Archives
PDF (flux de métadonnées + XMP + post-EOF), HTML (commentaires + éléments cachés + attributs de données + largeur nulle), XML (CDATA + instructions de traitement + espaces de noms), JSON (séquences d'échappement Unicode + ordre des clés), CSV/YAML/TOML/INI (codage de commentaires + espaces), RTF (groupes de texte cachés), Markdown (commentaires HTML + références de liens), ZIP/TAR/GZip (commentaires + en-têtes étendus + champs supplémentaires), SQLite (tables cachées), et plus.

### Techniques de Code
Python, JavaScript, C, CSS, Shell, SQL, LaTeX — tous avec commentaires stéganographiques, tables d'octets hexadécimaux, docstrings de largeur nulle, et entrées d'étalonnage par octet.

> *⊰•-•✧ Voir le catalogue complet : [`examples/README.md`](https://github.com/elder-plinius/st3gg/blob/main/examples/README.md) ✧•-•⊱*

---

## ⊰ Démarrage Rapide ⊱

### Installation depuis PyPI```bash
pip install stegg

### Installer avec extras```bash
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

Tout s'exécute 100 % côté client. Aucune donnée ne quitte jamais votre machine.

### Depuis la source```bash
git clone https://github.com/elder-plinius/st3gg.git
cd st3gg
pip install -e ".[all]"

### Intégration d'agents IA

Deux interfaces pour les agents IA — choisissez en fonction des besoins de coût de contexte :```bash
# 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

Une image 1920x1080 avec RGB 1 bit occupe ~760 Ko. Avec RGBA 4 bits : **~4 Mo**.

---

## ⊰ Chiffrement ⊱

| Méthode | Force | Vitesse | Cas d'utilisation |
|--------|----------|-------|----------|
| **AES-256-GCM** | Maximale | Moyenne | Mode Fantôme |
| **XOR Obfuscation** | Minimale | Rapide | Embrouillage basique uniquement (pas de chiffrement) |
| **Aucun** | - | Plus rapide | Quand le secret n'est pas nécessaire |

---

## ⊰ Bibliothèque d'exemples ⊱

ST3GG est livré avec **plus de 100 fichiers d'exemple pré-encodés** couvrant toutes les techniques — images, audio, documents, captures réseau, fichiers de code, et plus. Chacun contient un message caché que les outils d'analyse peuvent trouver.```bash
# Regenerate all examples
python examples/generate_examples.py

# Run the full test suite (200+ tests)
python test_examples.py

---

## ⊰ Notes de Sécurité ⊱

- La stéganographie LSB standard est **statistiquement détectable** — l'analyse chi-carré et l'analyse des plans de bits peuvent la révéler
- **SPECTER Channel Cipher** augmente la résistance en sautant de manière imprévisible entre les canaux
- **Ghost Mode** ajoute chiffrement + brouillage + bruit pour une discrétion maximale
- **Mode DCT** conçu pour la résistance à la compression ; **mode F5** prouvé pour survivre à la recompression JPEG
- **LSB** est détruit par TOUTE compression JPEG — utilisez uniquement le format PNG
- Toujours **chiffrer** les données sensibles avant l'incorporation
- Pour une sécurité maximale : **Ghost Mode + DCT + mot de passe fort**

---

## ⊰ Feuille de Route ⊱```
╔══════════════════════════════════════════════════════════════════╗
║                    ST3GG EVOLUTION ROADMAP                       ║
╠══════════════════════════════════════════════════════════════════╣
║                                                                  ║
║  ✅ SHIPPED                                                      ║
║  ────────                                                        ║
║  ✓ 112 steganographic techniques across all modalities           ║
║  ✓ 15 channel presets × 8 bit depths = 120 LSB combinations     ║
║  ✓ 8 encoding methods (LSB, DCT, PVD, F5, Chroma, Palette,     ║
║    Spread Spectrum, SPECTER channel cipher)                      ║
║  ✓ AI Agent with Reveal + Conceal modes                          ║
║  ✓ 13 text steganography methods with encode + decode            ║
║  ✓ 50 registered analysis/decode tools                           ║
║  ✓ RS Analysis + Sample Pairs Analysis (academic steganalysis)   ║
║  ✓ Raw PNG parser (bypasses canvas premultiplied alpha)          ║
║  ✓ Password-derived headers (stealth mode)                       ║
║  ✓ AES-256-GCM with PBKDF2 600k iterations                      ║
║  ✓ AI carrier image generation (OpenRouter + procedural)         ║
║  ✓ 109 example files, 568 automated tests                        ║
║  ✓ pip install stegg                                              ║
║  ✓ 100% browser-based at ste.gg                                  ║
║                                                                  ║
║  🔜 NEXT UP                                                      ║
║  ──────────                                                      ║
║  ○ Spread + Randomized strategies in browser                     ║
║    (defined but only interleaved is implemented)                 ║
║  ○ Password brute-forcer with wordlist support                   ║
║    (Stegseek does 10M/sec — we should match it)                 ║
║  ○ Content-adaptive embedding (HUGO/WOW-inspired)                ║
║    (embed in texture, skip smooth areas)                         ║
║  ○ Steghide format compatibility                                 ║
║    (read/write steghide's embedding format)                      ║
║  ○ Weighted Stego (WS) analysis                                  ║
║    (more accurate LSB detection than chi-square)                 ║
║  ○ Calibrated RS/SPA for real-world detection accuracy           ║
║                                                                  ║
║  🔮 FUTURE                                                       ║
║  ──────────                                                      ║
║  ○ ML-based steganalysis                                         ║
║    (CNN trained on StegoAppDB — Aletheia-grade detection)        ║
║  ○ nsF5 / S-UNIWARD embedding                                    ║
║    (academic state-of-the-art, minimal detectability)            ║
║  ○ Adversarial steganography                                     ║
║    (GAN-based embedding that defeats ML detectors)               ║
║  ○ Video steganography (frame-by-frame + temporal)               ║
║  ○ Network protocol live capture + injection                     ║
║    (real-time covert channel creation, not just PCAPs)           ║
║  ○ WebAssembly acceleration for browser-side analysis            ║
║  ○ Plugin system for community-contributed techniques            ║
║  ○ Mobile-native app (iOS/Android)                               ║
║  ○ VS Code / JetBrains extension for inline text steg            ║
║  ○ MCP server for Claude Code / AI agent integration             ║
║                                                                  ║
║  🌊 MOONSHOTS                                                    ║
║  ────────────                                                    ║
║  ○ Quantum-resistant steganographic protocols                    ║
║  ○ Blockchain-anchored provenance watermarking                   ║
║  ○ Cross-modal steganography (hide audio in images,              ║
║    images in text, text in network traffic)                      ║
║  ○ Federated steganalysis (distributed detection network)        ║
║  ○ Self-modifying steganographic payloads                        ║
║  ○ Steganographic filesystem (deniable encryption layer)         ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

Domaines où nous apprécierions particulièrement des contributions :
- **ML steganalysis** — entraîner des modèles de détection sur des jeux de données stéganographiques
- **New encoding methods** — techniques académiques (HUGO, WOW, HILL, UNIWARD)
- **Support de formats** — stéganographie pour HEIC, AVIF, FLAC, MP4
- **Steghide compatibility** — lire/écrire le format de steghide nativement
- **Performance** — WebAssembly pour l'analyse côté navigateur
- **Mobile** — améliorations responsives, wrappers d'applications natives

---

## ⊰ License ⊱

**AGPL-3.0** — libre et open source pour les particuliers, chercheurs, éducateurs et projets open source. Voir [LICENSE](https://github.com/elder-plinius/st3gg/blob/main/LICENSE) pour les détails.

**Usage entreprise / Commercial ?** Si vous souhaitez utiliser ST3GG dans un produit propriétaire ou un SaaS sans ouvrir votre code, contactez-nous pour une licence commerciale.

Cet outil est destiné à la **recherche en sécurité autorisée**, aux **compétitions CTF**, à la **formation en criminalistique numérique** et à la **recherche sur la vie privée**. Utilisez-le de manière responsable.

---

<div align="center">```
⊰•-•✧•-•-⦑ ST3GG ⦒-•-•✧•-•⊱
  every pixel has a story
    you just can't see it
           🦕︁