# 1. Спрятать файл внутри изображения (AES-256-GCM шифрование, авто-метод)
stegoforge encode -c photo.png -p secret.pdf -k "my-pass"

# 2. Извлечь скрытый файл
stegoforge decode -f photo_stego.png -k "my-pass"

# 3. CTF — одноточечный криминалистический дамп любого подозрительного файла
stegoforge ctf -f suspicious.mp3

# 4. Сравнить оригинал и стего — тепловая карта пикселей
stegoforge diff -c photo.png -s photo_stego.png

# 5. Пакетное внедрение секрета во все носители в папке
stegoforge batch -d ./carriers/ -p secret.txt -k "my-pass"

# 6. Проверить ёмкость и оценку скрытности носителя
stegoforge capacity -c photo.png --depth 2

# 7. Имитировать рекомпрессию Twitter и проверить, выживет ли нагрузка
stegoforge encode -c photo.png -p secret.txt -k "my-pass" --target twitter --test-survival

# 8. Запустить локальный веб-интерфейс (данные никогда не покидают вашу машину)
stegoforge web

# Установить автодополнение (bash)
eval "$(stegoforge completion bash)"

# Использовать переменную окружения, чтобы не вводить ключ в истории оболочки
export STEGOFORGE_KEY="my-pass"
stegoforge decode -f stego.png   # ключ читается из окружения

$ stegoforge encode --carrier cover.png --payload secret.txt --key "mypassword" --method lsb
[+] Полезная нагрузка зашифрована с помощью AES-256-GCM
[+] Внедрено 2048 бит через RGB-каналы (глубина 1 бит)
[+] Выход: cover_stego.png
[+] Статистический профиль: неотличим от базового (χ² = 0.021)

$ stegoforge ctf --file suspicious.mp3
[*] Запуск всех детекторов на suspicious.mp3 ...
[⏭] Хи-квадрат аномалия LSB      ПРОПУЩЕНО
[⏭] RS-анализ                    ПРОПУЩЕНО 
[!] Слепой экстрактор обнаружил нагрузку: audio-lsb, глубина=1, зашифрованный AES блок
[+] Извлечено 412 байт → сохранено в extracted_payload.bin

stegoforge/
├── Изображения-носители      PNG · JPEG · BMP · GIF · WebP
│   ├── LSB / Адаптивный LSB  глубина 1–4 бита + упорядочивание стоимости на основе содержимого (WOW)
│   ├── DCT + безопасный предел JND  Встраивание в частотную область JPEG + перцептивный бюджет Уотсона
│   ├── LSB с отпечатком     Режим встраивания с учётом PRNU
│   └── Альфа / Палитра      Каналы прозрачности и индексированных цветов
│
├── Видео-носители           MP4 · WebM
│   ├── DCT видео            Встраивание в ключевые кадры с ранжированием по стоимости блоков
│   ├── Движение видео       Встраивание в блоки, маскированные по времени+текстуре (MP4)
│
├── Аудио-носители           WAV · FLAC · MP3 · OGG
│   ├── LSB сэмплов          PCM LSB с псайхоакустическим упорядочиванием стоимости
│   ├── Фазовое кодирование  Кодирование в сегменты фазы
│   └── Спектрограмма        Визуальные полезные нагрузки в спектральной области
│
├── Документы-носители       TXT · PDF · DOCX · XLSX
│   ├── Юникодные пробелы    Адаптивное ранжирование точек вставки (ZWSP/ZWNJ/ZWJ)
│   ├── Лингвистический режим  Текстовая стеганография с синонимическим каналом на основе ключа
│   ├── PDF-потоки           Инъекция в объекты/потоки/метаданные
│   └── Office XML           Пользовательские XML-части и потоки
│
├── Бинарные носители        ELF · PE/EXE/DLL (CLI)
│   ├── Slack/notes ELF      Встраивание с маскировкой 2-битной стоимости региона
│   ├── Slack/overlay PE     Встраивание с маскировкой 2-битной стоимости региона
│
├── Сетевые скрытые каналы (CLI)
│   ├── Каналы TCP-полей     ip_id, tcp_seq, ttl
│   └── Временные каналы     Кодирование задержками между пакетами
│
├── Крипто + Выживаемость
│   ├── AES-256-GCM + Argon2
│   ├── Режим приманки       Правдоподобное отрицание с двойной полезной нагрузкой
│   ├── Обёртка Wet-Paper    Устойчивый конверт с кодом Рида-Соломона
│   └── Профили платформ     Выбор/симуляция метода с учётом соцсетей
│
└── Интерфейсы
  ├── CLI                    Гибридный групповой выбор методов + полноценный командный режим
  ├── Веб-интерфейс (Flask)  Групповые пилюли методов, гибридные значки, локальная SSE-трансляция
  └── Режим CTF             Одна команда, все релевантные детекторы, ранжированный отчёт

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  # Автоматически разворачивается на http://localhost:5000

stegoforge

# Базовый LSB в PNG
stegoforge encode -c photo.png -p message.txt -k "passphrase"

# Скрытный JPEG DCT с пользовательской глубиной бит
stegoforge encode -c photo.jpg -p secret.bin -k "key" --method dct

# Спектрограмма — скрыть визуальное изображение внутри воспроизводимого аудио
stegoforge encode -c music.wav -p logo.png --method spectrogram

# Режим приманки — создаёт два ключа, скрывая две нагрузки в одном файле для правдоподобного отрицания
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

# Запустить полный эвристический набор нативно (Настоятельно рекомендуется)
stegoforge ctf -f suspicious.png

# Целевое ML / Статистическое обнаружение
stegoforge detect --chi2 -f image.png
stegoforge detect --rs -f image.png

# Внедрить нагрузку и безопасно отправить её как замаскированный HTTP-пакет
stegoforge deadrop post -c cover.png -p msg.txt -k "shared_key"

# Мониторить URL удалённого изображения на наличие изменений нагрузки
stegoforge deadrop monitor --url "https://example.com/image.png" -k "shared_key" --interval 20