# 1. Verstecke eine Datei in einem Bild (AES-256-GCM verschlüsselt, automatische Methode)
stegoforge encode -c photo.png -p secret.pdf -k "my-pass"

# 2. Rufe die versteckte Datei ab
stegoforge decode -f photo_stego.png -k "my-pass"

# 3. CTF-One-Click-Forensik-Dump für jede verdächtige Datei
stegoforge ctf -f suspicious.mp3

# 4. Vergleiche Original vs. Stego – Pixel-Heatmap
stegoforge diff -c photo.png -s photo_stego.png

# 5. Batch-Einbettung eines Geheimnisses in jeden Träger eines Ordners
stegoforge batch -d ./carriers/ -p secret.txt -k "my-pass"

# 6. Prüfe Kapazität und Tarnungs-Score eines Trägers
stegoforge capacity -c photo.png --depth 2

# 7. Simuliere Twitter-Neukompression und teste, ob Payload überlebt
stegoforge encode -c photo.png -p secret.txt -k "my-pass" --target twitter --test-survival

# 8. Starte die lokale Weboberfläche (Daten verlassen niemals deinen Rechner)
stegoforge web

# Installiere Tab-Vervollständigung (bash)
eval "$(stegoforge completion bash)"

# Nutze Umgebungsvariable, um Schlüssel im Shell-Verlauf zu vermeiden
export STEGOFORGE_KEY="my-pass"
stegoforge decode -f stego.png   # Schlüssel aus Umgebungsvariable

$ stegoforge encode --carrier cover.png --payload secret.txt --key "mypassword" --method lsb
[+] Payload mit AES-256-GCM verschlüsselt
[+] 2048 Bits über RGB-Kanäle eingebettet (1-Bit-Tiefe)
[+] Ausgabe: cover_stego.png
[+] Statistisches Profil: nicht unterscheidbar vom Ausgangsmaterial (Chi² = 0,021)

$ stegoforge ctf --file suspicious.mp3
[*] Führe alle Detektoren auf suspicious.mp3 aus ...
[⏭] Chi-Quadrat-LSB-Anomalie      ÜBERSPRUNGEN
[⏭] RS-Analyse                    ÜBERSPRUNGEN
[!] Blindextraktor hat Payload gefunden bei: audio-lsb, Tiefe=1, AES-verschlüsselter Blob
[+] 412 Bytes extrahiert → gespeichert in extracted_payload.bin

stegoforge/
├── Bild-Träger          PNG · JPEG · BMP · GIF · WebP
│   ├── LSB / Adaptives LSB  1–4 Bit Tiefe + WOW-artige inhaltssensitive Kostenordnung
│   ├── DCT + JND-sichere Obergrenze  JPEG-Frequenzbereichseinbettung + Watson-artiges Wahrnehmungsbudget
│   ├── Fingerabdruck-LSB     PRNU-bewusster Einbettungsmodus
│   └── Alpha / Palette       Transparenz- und indizierte Farbkanäle
│
├── Video-Träger          MP4 · WebM
│   ├── Video-DCT           Keyframe-Einbettung mit Blockkosten-Ranking
│   └── Video-Bewegung      Zeitlich+texturmaskierte Blockeinbettung (MP4)
│
├── Audio-Träger          WAV · FLAC · MP3 · OGG
│   ├── Sample-LSB          Psychoakustik-artige kostenbasierte PCM-LSB-Ordnung
│   ├── Phasenkodierung     Segment-Phasenkodierung
│   └── Spektrogramm-Kunst  Visuelle Payloads im Spektralbereich
│
├── Dokument-Träger       TXT · PDF · DOCX · XLSX
│   ├── Unicode-Leerzeichen  Adaptive Einfügepunkt-Rangfolge (ZWSP/ZWNJ/ZWJ)
│   ├── Linguistischer Modus Schlüsselbewusster Synonym-Kanal-Text-Steganografie
│   ├── PDF-Streams          Objekt-/Stream-/Metadaten-Injektion
│   └── Office-XML           Benutzerdefinierte XML-Teile und Streams
│
├── Binär-Träger          ELF · PE/EXE/DLL (CLI)
│   ├── ELF Slack/Notizen    2-Bit maskierte Bereichskosten-Einbettung
│   └── PE Slack/Overlay     2-Bit maskierte Bereichskosten-Einbettung
│
├── Netzwerk-Covert-Channels (CLI)
│   ├── TCP-Feld-Channels  ip_id, tcp_seq, ttl
│   └── Timing-Channel      Inter-Paket-Verzögerungskodierung
│
├── Krypto + Überlebensfähigkeit
│   ├── AES-256-GCM + Argon2
│   ├── Decoy-Modus          Dual-Payload-plausible-Abstreitbarkeit
│   ├── Wet-Paper-Wrapping   Reed-Solomon-Resilienz-Wrapper
│   └── Plattform-Profile    Social-Media-bewusste Methodenauswahl/Simulation
│
└── Schnittstellen
  ├── CLI                 Hybrid-First-gruppierte Methodenauswahl + vollständiger Befehlsmodus
  ├── Web-UI (Flask)      Gruppierte Methoden-Pills, Hybrid-Badges, lokales SSE-Streaming
  └── CTF-Modus            Ein Befehl, alle relevanten Detektoren, bewerteter Bericht

git clone https://github.com/Nour833/StegoForge.git
cd StegoForge
pip install -r requirements.txt
pip install -r requirements-web.txt
pip install -e .

stegoforge web  # Wird automatisch unter http://localhost:5000 bereitgestellt

stegoforge

# Einfaches LSB in PNG
stegoforge encode -c photo.png -p message.txt -k "Passphrase"

# Tarnstarke JPEG-DCT mit benutzerdefinierter Bittiefe
stegoforge encode -c photo.jpg -p secret.bin -k "key" --method dct

# Spektrogramm-Kunst – Verstecke ein Bild in abspielbarem Audio
stegoforge encode -c music.wav -p logo.png --method spectrogram

# Decoy-Modus – Erzeugt zwei Schlüssel und versteckt zwei Payloads in einer Datei für plausible Abstreitbarkeit
stegoforge encode -c photo.png -p real_secret.txt -k "realkey" \
                  --decoy decoy_message.txt --decoy-key "duresskey"

stegoforge decode -f photo_stego.png -k "Passphrase"
stegoforge decode -f music_stego.wav -k "key" --method phase

# Führe das komplette heuristische Arsenal nativ aus (sehr empfohlen)
stegoforge ctf -f suspicious.png

# Gezielte ML-/Statistische Erkennung
stegoforge detect --chi2 -f image.png
stegoforge detect --rs -f image.png

# Betten Sie einen Payload ein und POSTen Sie ihn sicher als getarntes HTTP-Paket
stegoforge deadrop post -c cover.png -p msg.txt -k "shared_key"

# Überwachen Sie eine entfernte Bild-URL auf eingehende Payload-Änderungen
stegoforge deadrop monitor --url "https://example.com/image.png" -k "shared_key" --interval 20