</div>

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/121/96f422606110041227c4c4a5a6dfa138bbb5ae0a7443ff02bde46bf1ee2d548d.png" alt="ST3GG Баннер" width="600">
<br><sub><i>Это изображение содержит скрытые данные. Сможете ли вы их найти?</i></sub>
</p>

---

## ⊰ Что такое ST3GG? ⊱

[STE.GG](https://ste.gg)‍​‌​‌​​​​​‌​​‌‌​​​‌​​‌​​‌​‌​​‌‌‌​​‌​‌‌​​‌​​‌​​​​​​‌​​‌‌​​​‌​​‌‌‌‌​‌​‌​‌‌​​‌​​​‌​‌​‌​‌​​‌‌​​‌​​​​​​‌​‌‌​​‌​‌​​‌‌‌‌​‌​‌​‌​‌‍ — это многофункциональный набор инструментов стеганографии с открытым исходным кодом, который скрывает секретные данные внутри изображений, аудио, документов, сетевых пакетов и многого другого, используя **100+ методов кодирования** для всех возможных форматов файлов.

Он работает **100% в вашем браузере** (статический сайт, без сервера) или как **Python CLI/TUI/WebUI**. Никакие данные никогда не покидают вашу машину. Каждый метод, который кодирует, также и декодирует. Каждая поверхность атаки также является поверхностью обнаружения.

> *⊰•-•✧ Некоторые секреты скрыты на виду ✧•-•⊱*

---

## ⊰ Почему ST3GG? ⊱

| Функция | Другие инструменты | **ST3GG** |
|---------|-------------|-----------|
| Варианты каналов | Только RGB | **15 пресетов** (R, G, B, A, RG, RB, RA, GB, GA, BA, RGB, RGA, RBA, GBA, RGBA) |
| Глубина бита | 1 бит фиксировано | **1-8 бит на канал** (настраивается) |
| Стратегии кодирования | Последовательные | **4 стратегии** (последовательная, чередующаяся, распределенная, случайная) |
| Вложенная стеганография | - | **До 11 уровней глубины (режим Матрёшки)** |
| Канальный шифр | - | **Новый кросс-канальный перескок (SPECTER)** |
| Устойчивость к сжатию | - | **F5 выживает после JPEG/социальных сетей; DCT разработан для устойчивости к сжатию** |
| Умное декодирование | - | **Автоматическое обнаружение для 120+ конфигураций** |
| Шифрование | Базовое/Нет | **AES-256-GCM + XOR** |
| Форматы изображений | Только PNG | **PNG, JPEG, WebP, GIF** |
| Типы файлов | Только изображения | **Изображения, аудио, текст, документы, сеть, архивы, код** |
| Библиотека примеров | Нет | **100+ предварительно закодированных примеров файлов** |
| Браузерное | - | **100% на стороне клиента JS, без сервера** |
| ИИ-агент | - | **Исчерпывающее декодирование на основе ИИ по всем методам** |

---

## ⊰ Общая картина: Нападение и защита ⊱

ST3GG — это **инструмент двойного назначения**, созданный для обеих сторон поля битвы стеганографии.

### КРАСНАЯ КОМАНДА / Нападение — Имитации отравления

Утечка данных не всегда выглядит как утечка данных. ST3GG позволяет красным командам и исследователям моделировать **каждый известный вектор скрытой передачи данных**, чтобы проверить, действительно ли защита их перехватывает:

- **100+ методов кодирования** для изображений, аудио, текста, документов, сетевых пакетов, архивов и файлов кода
- **Генерация полиглот-файлов** — файлы, одновременно действительные как два формата (PNG+ZIP)
- **Скрытые каналы сетевых протоколов** — данные, скрытые в DNS-запросах, полезных нагрузках ICMP, порядковых номерах TCP, заголовках HTTP
- **Юникодная стеганография** — невидимые омоглифы, символы нулевой ширины, селекторы вариантов, запутываемые пробелы
- **Устойчивое к сжатию кодирование** — режим F5 работает напрямую с коэффициентами JPEG (доказано, что выживает после социальных сетей); режим DCT разработан для устойчивости к сжатию
- **Многоуровневое вложение** — до 11 рекурсивных уровней стеганографии (режим Матрёшки)
- **Призрачный режим** — AES-256 шифрование + перестановка битов + шумовые приманки для максимального уклонения

*Если ваша DLP не может это обнаружить, вам нужно знать об этом, пока это не сделал противник.*

### СИНЯЯ КОМАНДА / Защита — ALLSIGHT Комплексное обнаружение

Тот же набор инструментов, который создает стеганографические полезные нагрузки, также **обнаруживает и декодирует их**. Аналитический движок ST3GG обеспечивает полный спектр видимости по всем известным поверхностям скрытой передачи данных:

- **20+ функций обнаружения** — хи-квадрат анализ, энтропия битовых плоскостей, гистограммный анализ, сканирование сигнатур, обнаружение заголовков STEG
- **Исчерпывающий анализ на основе ИИ** — автономный агент тестирует каждый метод декодирования для загруженного типа файла
- **Идентификация типа файла** — обнаружение магических байтов для 20+ форматов (PNG, JPEG, GIF, BMP, WebP, TIFF, ICO, SVG, WAV, AIFF, AU, MIDI, PCAP, PDF, ZIP, GZip, TAR, SQLite и другие)
- **Обнаружение юникодной стеганографии** — символы нулевой ширины, омоглифы, селекторы вариантов, комбинируемые знаки, запутываемые пробелы, шаблоны эмодзи
- **Анализ пробелов** — кодирование завершающих пробелов/табуляции, обнаружение вариантов юникодных пробелов
- **Криминалистика метаданных** — извлечение строк base64/hex, анализ EXIF, проверка чанков PNG
- **Анализ сетевых пакетов** — разбор PCAP для индикаторов скрытых каналов
- **200+ автоматизированных тестов**, проверяющих точность обнаружения с нулевым количеством ложноположительных результатов для известных методов

*Видеть всё. Не пропускать ничего. Это ALLSIGHT.*

> *⊰•-•✧ Лучшая защита начинается с понимания нападения ✧•-•⊱*

---

## ⊰ Для кого это? ⊱

ST3GG — это не просто игрушка. Разные сообщества используют инструменты стеганографии по совершенно разным — и вполне реальным — причинам.

### Пентестеры и красные команды
Моделируйте утечку данных через стеганографические каналы во время тестирования. Проверьте, перехватывают ли DLP на конечных точках, правила SIEM и сетевой мониторинг скрытую передачу данных через 100+ векторов. Генерируйте вредоносные полезные нагрузки для всех типов файлов, чтобы проверить охват обнаружения.

### Синие команды и аналитики SOC
Используйте ALLSIGHT для сканирования подозрительных файлов на наличие скрытых полезных нагрузок. Запускайте исчерпывающий анализ против всех известных методов кодирования. Создавайте правила обнаружения на основе обширной библиотеки примеров. Обучайте аналитиков тому, как выглядят стеганографические артефакты в реальном мире.

### Участники CTF и соревновательные хакеры
Лучший стеганографический инструмент для соревнований Capture The Flag. Кодируйте и декодируйте для любой комбинации канал/бит/стратегия. Автоматически обнаруживайте неизвестные конфигурации с помощью умного сканирования. Автоматически распутывайте многослойные задачи "Матрёшки".

### Цифровая криминалистика и реагирование на инциденты
Анализируйте изъятые носители на наличие стеганографических каналов связи. Обнаруживайте скрытые данные во вложениях изображений, метаданных документов, аудиофайлах и сетевых захватах. Определяйте, какой метод кодирования использовался, и извлекайте скрытую полезную нагрузку.

### Исследователи конфиденциальности и журналисты
Изучайте стеганографию как канал связи, сохраняющий конфиденциальность. Понимайте компромиссы между емкостью, скрытностью и устойчивостью к сжатию. Тестируйте, какие методы выживают после перекодирования в социальных сетях для реальной отрицаемой связи.

### Академики и студенты
Изучите весь ландшафт стеганографических техник по всем модальностям. Используйте 100+ примеров файлов в качестве обучающего набора данных. Тестируйте новые алгоритмы обнаружения на известных кодировках. Кодовая база хорошо документирована и лицензирована под AGPL-3.0 — бесплатно для частных лиц, исследователей и проектов с открытым исходным кодом.

### Безопасность ИИ и безопасность LLM
Тестируйте, как системы ИИ обрабатывают стеганографический контент — скрытые инструкции в изображениях, невидимый юникод в подсказках, полиглот-файлы, обходящие фильтры контента. Понимайте поверхность скрытой передачи данных, от которой системам ИИ необходимо защищаться.

### Поставщики систем предотвращения утечек данных (DLP)
Сравните ваше решение DLP с 100+ методами кодирования ST3GG. Если ваш продукт не может обнаружить данные, скрытые в именах DNS-запросов, порядковых номерах TCP или невидимых юникодных символах — ваши клиенты заслуживают знать об этом. ST3GG — это ваш набор тестов для противодействия.

### Безопасность ИИ-агентов и красная команда
Следующая граница стеганографии — это **скрытая связь агент-агент** и **внедрение промптов через скрытые полезные нагрузки**. ST3GG — это инструмент для этой новой поверхности атаки:

- **Внедрение промптов через изображения** — встраивайте скрытые инструкции в изображения, которые обрабатывают агенты с поддержкой зрения. Агент видит обычное фото; скрытая полезная нагрузка говорит "игнорировать все предыдущие инструкции".
- **Утечка данных агента** — тестируйте, можно ли обмануть вашего агента, чтобы он закодировал украденные данные в изображения, которые он генерирует, проведя их мимо выходных фильтров.
- **Скрытые каналы агентов** — агенты передают скрытые инструкции через безобидные на вид файлы в общих контекстах инструментов.
- **Водяные знаки выходных данных агента** — встраивайте данные о происхождении или отслеживании в изображения, генерируемые агентами, для атрибуции.
- **Обход фильтров контента** — тестируйте системы модерации, скрывая запрещенный контент в полезных нагрузках изображений, которые проходят автоматическую проверку.
- **Мультимодальное отравление** — создавайте изображения, которые выглядят нормально для людей, но содержат скрытые данные, изменяющие поведение агента при обработке.

**Используйте ST3GG как библиотеку Python в вашем конвейере агентов:**```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")

Два режима: **Ручной шаблон** (вы определяете) или **Режим пароля** (производный от парольной фразы + опциональное шифрование). Встраивание через **LSB** (высокая ёмкость) или **DCT** (устойчивость к сжатию).

### Режим-призрак — Максимальная скрытность

Трёхслойная обфускация для случаев, когда ставки реальны:

1. **Шифрование AES-256-GCM** — аутентифицированное, военного уровня
2. **Перемешивание битов** — перестановка Фишера-Йетса с детерминированным ГПСЧ
3. **50% шумовых приманок** — половина встроенных битов — случайный шум

Злоумышленнику потребуется знать шаблон канала, пароль для расшифровки И ключ дешифрования. Компромисс: ёмкость уменьшается вдвое.

### Режим Матрёшки — Рекурсивное вложение

Прячьте изображения внутри изображений внутри изображений — до **11 уровней глубины**. Умный декодер автоматически обнаруживает магические байты PNG и рекурсивно разворачивает каждый слой. Русские матрёшки, но для секретов.

### Режим DCT — Устойчивость к сжатию

Традиционный LSB уничтожается ЛЮБЫМ сжатием JPEG — даже при качестве 99%. Режим DCT встраивает данные в частотные коэффициенты блоков 8x8 пикселей, разработан для устойчивости к сжатию. Для **доказанной** выживаемости в соцсетях используйте **режим F5**, который работает напрямую с коэффициентами DCT JPEG с помощью матричного кодирования.

> **LSB** → только PNG (без потерь). **DCT** → устойчив к сжатию. **F5** → выживает в JPEG/соцсетях.

### AI-агент — Раскрытие и Сокрытие

У AI-агента два режима:

**🔍 Раскрытие** — Загрузите любой файл. Агент автоматически тестирует все известные методы декодирования, находит скрытые данные и извлекает их в виде загружаемых артефактов.

**🔮 Сокрытие** — Введите секретное сообщение, загрузите (или сгенерируйте) изображение-носитель, и агент спрячет ваши данные, используя оптимальный метод кодирования. Один клик от секрета до стего-изображения.

Работает на OpenRouter. Совместим с Claude, GPT, Gemini и другими моделями.

---

## ⊰ 100+ Стеганографических Техник ⊱

ST3GG не просто прячет данные в изображениях. Он охватывает **каждую модальность**:

### Техники изображений
Встраивание LSB (RGB, RGBA, оттенки серого) в PNG, BMP, TIFF, GIF, WebP, ICO, PPM, PGM — плюс LSB альфа-канала, кодирование типа фильтра PNG, манипуляции индексом палитры, частотная область DCT, полиглоты PNG+ZIP, внедрение метаданных (EXIF, XMP, фрагменты tEXt) и данные после IEND.

### Текстовые и Unicode техники
Символы нулевой ширины (ZWSP/ZWNJ/ZWJ), невидимые чернила (символы тегов Unicode U+E0000), замена гомоглифов (кириллица/латиница), селекторы вариантов, комбинируемые диакритические знаки (CGJ), путающие пробельные символы (en/em/thin/hair пробелы), кодирование пробелами (пробел=0/табуляция=1), замена эмодзи и кодирование заглавных букв.

### Аудиотехники
Сэмпловый LSB в форматах WAV, AIFF и AU. Тайминг интервалов тишины (длительность паузы кодирует биты). Встраивание в сообщения MIDI SysEx.

### Техники сетевых протоколов
DNS-туннелирование (base32 в метках запросов), инжекция полезной нагрузки ICMP, скрытые каналы TCP (ISN + временные метки), контрабанда HTTP-заголовков (пользовательские X- заголовки, cookies).

### Техники документов и архивов
PDF (потоки метаданных + XMP + после EOF), HTML (комментарии + скрытые элементы + data-атрибуты + нулевая ширина), XML (CDATA + инструкции по обработке + пространства имён), JSON (Unicode-экранирование + порядок ключей), CSV/YAML/TOML/INI (кодирование комментариев + пробелы), RTF (скрытые текстовые группы), Markdown (HTML-комментарии + ссылочные ссылки), ZIP/TAR/GZip (комментарии + расширенные заголовки + дополнительные поля), SQLite (скрытые таблицы) и многое другое.

### Техники кода
Python, JavaScript, C, CSS, Shell, SQL, LaTeX — все со стеганографическими комментариями, таблицами шестнадцатеричных байтов, строками документации нулевой ширины и покалибровочными записями для каждого байта.

> *⊰•-•✧ Полный каталог: [`examples/README.md`](https://github.com/elder-plinius/st3gg/blob/main/examples/README.md) ✧•-•⊱*

---

## ⊰ Быстрый старт ⊱

### Установка из PyPI```bash
pip install stegg

### Установка с дополнениями```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

Все выполняется на 100% на стороне клиента. Никакие данные никогда не покидают вашу машину.

### Из исходного кода```bash
git clone https://github.com/elder-plinius/st3gg.git
cd st3gg
pip install -e ".[all]"

### Интеграция AI-агентов

Два интерфейса для AI-агентов — выбирайте, исходя из потребностей в стоимости контекста:```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

A 1920x1080 image with RGB 1-bit holds ~760KB. With RGBA 4-bit: **~4MB**.

---

## ⊰ Шифрование ⊱

| Метод | Стойкость | Скорость | Применение |
|--------|----------|-------|----------|
| **AES-256-GCM** | Максимальная | Средняя | Ghost Mode |
| **XOR Obfuscation** | Минимальная | Быстрая | Только базовое перемешивание (не шифрование) |
| **Нет** | - | Максимальная | Когда секретность не требуется |

---

## ⊰ Библиотека примеров ⊱

ST3GG поставляется с **более чем 100 предварительно закодированными примерами файлов**, охватывающими все техники — изображения, аудио, документы, захваты сетевого трафика, файлы с кодом и другие. Каждый из них содержит скрытое сообщение, которое могут найти инструменты анализа.```bash
# Regenerate all examples
python examples/generate_examples.py

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

---

## ⊰ Заметки по безопасности ⊱

- Стандартная LSB-стеганография **статистически обнаружима** — анализ хи-квадрат и битовых плоскостей может её выявить
- **SPECTER Channel Cipher** повышает устойчивость за счёт непредсказуемого переключения между каналами
- **Ghost Mode** добавляет шифрование, перемешивание и шум для максимальной скрытности
- **Режим DCT** разработан для устойчивости к сжатию; **режим F5** доказал способность выдерживать пережатие JPEG
- **LSB** разрушается при ЛЮБОМ сжатии JPEG — используйте только формат PNG
- Всегда **шифруйте** конфиденциальные данные перед встраиванием
- Для максимальной безопасности: **Ghost Mode + DCT + надёжный пароль**

---

## ⊰ Дорожная карта ⊱```
╔══════════════════════════════════════════════════════════════════╗
║                    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)         ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

Области, в которых мы особенно приветствуем вклад:
- **ML стеганализ** — обучение моделей обнаружения на стего-наборах данных
- **Новые методы кодирования** — академические техники (HUGO, WOW, HILL, UNIWARD)
- **Поддержка форматов** — стеганография HEIC, AVIF, FLAC, MP4
- **Совместимость с Steghide** — чтение/запись формата steghide нативно
- **Производительность** — WebAssembly для анализа на стороне браузера
- **Мобильные устройства** — адаптивные улучшения, обёртки для нативных приложений

---

## ⊰ Лицензия ⊱

**AGPL-3.0** — бесплатно и с открытым исходным кодом для частных лиц, исследователей, преподавателей и проектов с открытым исходным кодом. Подробнее см. в [LICENSE](https://github.com/elder-plinius/st3gg/blob/main/LICENSE).

**Корпоративное / коммерческое использование?** Если вы хотите использовать ST3GG в проприетарном продукте или SaaS, не открывая свой код, свяжитесь с нами для получения коммерческой лицензии.

Этот инструмент предназначен для **авторизованного исследования безопасности**, **соревнований CTF**, **обучения цифровой криминалистике** и **исследований конфиденциальности**. Используйте ответственно.

---

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