# 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. محاكاة إعادة ضغط تويتر واختبار بقاء الحمولة
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
[+] الملف الإحصائي: لا يمكن تمييزه عن الأساس (chi² = 0.021)

$ stegoforge ctf --file suspicious.mp3
[*] تشغيل جميع الكاشفات على suspicious.mp3 ...
[⏭] شذوذ Chi-square LSB      تم تخطيه
[⏭] تحليل RS                  تم تخطيه 
[!] وجد المستخرج الأعمى حمولة في: audio-lsb, depth=1, blob مشفر بـ AES
[+] استخرج 412 بايت → حفظ إلى extracted_payload.bin

stegoforge/
├── ناقلات الصور          PNG · JPEG · BMP · GIF · WebP
│   ├── LSB / LSB تكيفي     عمق 1–4 بت + ترتيب تكلفة واعي بالمحتوى بأسلوب WOW
│   ├── DCT + حد أمان JND  تضمين في مجال التردد JPEG + ميزانية إدراكية بأسلوب Watson
│   ├── LSB البصمة         وضع تضمين واعي بـ PRNU
│   └── قناة الشفافية/اللوحة    قنوات الشفافية والألوان المفهرسة
│
├── ناقلات الفيديو          MP4 · WebM
│   ├── DCT الفيديو         تضمين الإطارات المفتاحية مع ترتيب تكلفة الكتل
│   └── حركة الفيديو        تضمين الكتل المقنعة زمنيًا+نسيجيًا (MP4)
│
├── ناقلات الصوت           WAV · FLAC · MP3 · OGG
│   ├── عينة LSB            PCM LSB مرتب التكلفة بأسلوب سمعي نفسي
│   ├── ترميز الطور         ترميز طور المقطع
│   └── فن الطيف           حمولات بصرية في مجال الطيف
│
├── ناقلات المستندات        TXT · PDF · DOCX · XLSX
│   ├── فراغات يونيكود      ترتيب نقاط الإدراج التكيفي (ZWSP/ZWNJ/ZWJ)
│   ├── الوضع اللغوي       إخفاء نصي عبر قناة المرادفات واعية بالمفتاح
│   ├── تيارات PDF          حقن كائن/تيار/بيانات وصفية
│   └── XML المكتبي         أجزاء وتيارات XML مخصصة
│
├── ناقلات ثنائية           ELF · PE/EXE/DLL (CLI)
│   ├── مساحة ELK/ملاحظات   تضمين بتتان مقنعتان بتكلفة المنطقة
│   └── مساحة PE/تراكب      تضمين بتتان مقنعتان بتكلفة المنطقة
│
├── قنوات شبكة سرية (CLI)
│   ├── قنوات حقل TCP       ip_id, tcp_seq, ttl
│   └── قناة التوقيت        ترميز تأخير بين الحزم
│
├── التشفير + البقاء
│   ├── AES-256-GCM + Argon2
│   ├── وضع الإلهاء        إنكار معقول بحمولتين مزدوجتين
│   └── غلاف الورق الرطب   غلاف مرونة Reed-Solomon
│
└── الواجهات
  ├── 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"

# مراقبة رابط صورة عن بعد لاستقبال تغيير حمولة وارد
stegoforge deadrop monitor --url "https://example.com/image.png" -k "shared_key" --interval 20