___ ___         __             _________                       __
 /   |   \_____ _/  |_  ____     \_   ___ \____________    ____ |  | __
/    ~    \__  \\   __\/ __ \    /    \  \/\_  __ \__  \ _/ ___\|  |/ /
\    Y    // __ \|  | \  ___/    \     \____|  | \// __ \\  \___|    <
 \___|_  /(____  /__|  \___  >____\______  /|__|  (____  /\___  >__|_ \
       \/      \/          \/_____/      \/            \/     \/     \/

التثبيت

التثبيت من المصدر هو المسار الوحيد المدعوم. hate_crack ليس موزعًا على PyPI: pip install hate-crack يحل إلى عنصر نائب 0.0.0 يفشل عمدًا ويشير مرة أخرى إلى هنا. الاسم محجوز فقط حتى لا يتمكن أي شخص آخر من نشر نسخة مشابهة تحته — انظر packaging/pypi-placeholder/.

1. تثبيت hashcat

يجب تثبيت Hashcat وتوفيره في PATH الخاص بك:

Ubuntu/Kali:```bash sudo apt-get install -y hashcat

macOS (Homebrew):```bash
brew install hashcat

أو قم بتنزيل ملف ثنائي مُجمّع مسبقًا من https://hashcat.net/hashcat/ واضبط hcatPath في config.json على موقعه.

2. تنزيل hate_crack

استنسخ مع الوحدات الفرعية (مطلوبة لـ hashcat-utils و princeprocessor و pcfg_cracker و Corporate_Masks واختياريًا omen):```bash git clone --recurse-submodules https://github.com/trustedsec/hate_crack.git cd hate_crack

إذا استنسخت دون وحدات فرعية، قم بتهيئتها:```bash
git submodule update --init --recursive

ثم قم بتخصيص الإعدادات إذا لزم الأمر. يستخدم hate_crack ملفي إعدادات، لكل منهما مجموعة متميزة من الإعدادات:

• config.json — مسارات قوائم الكلمات، الأقنعة، القواعد، الضبط، ملف potfile، مسار hashcat، حدود المرشحين، مفاتيح الإشعارات، افتراضيات تفضيلات CLI (35 إعدادًا).
• .env — إعدادات تكامل الطرف الثالث فقط: بيانات اعتماد Hashview وHashmob، بيانات اعتماد Pushover، Ollama، وpipal (14 إعدادًا). غير متتبع بواسطة git، يُنشأ بوضع 0600.

يقع الخط هناك لسبب واحد: .env هو الملف الذي يمكن أن يحتوي على أسرار. بيانات الاعتماد الخاصة بخدمات الطرف الثالث وإعداداتها تذهب إلى الملف غير المتتبع ذي الوضع 0600؛ كل ما يفعله hate_crack محليًا يبقى في config.json، وهو آمن للمشاركة والمقارنة والتحقق منه في ملاحظاتك الخاصة. لهذا أيضًا تكون بيانات اعتماد Pushover في .env بينما مفاتيح تشغيل/إيقاف Pushover في config.json — المفاتيح تفضيلات محلية، وليست أسرارًا.

لكل مفتاح موطن واحد بالضبط. المفتاح الموضوع في الملف الآخر يُتجاهل، ويطبع hate_crack تحذيرًا يسمي الملف الذي ينتمي إليه. يمكن تجاوز أي مفتاح لتشغيل واحد عن طريق تصدير متغير البيئة الخاص به. يمكن لمعظم المستخدمين تخطي هذه الخطوة لأن المسارات الافتراضية تعمل مباشرة دون إعداد.

config.json دائم ومن الدرجة الأولى — لم يُهمل ولا يوجد جدول زمني لإزالته. فقط إعدادات التكامل انتقلت.

الترقية من config.json واحد؟ يقوم hate_crack بترحيله لك عند أول تشغيل: تُنسخ إعدادات التكامل إلى .env جديد بوضع 0600، ثم تُزال من config.json حتى لا يدّعي كلا الملفين ملكيتها. يطبع المفاتيح التي انتقلت (وليس قيمها أبدًا)، ويحفظ نسختك الأصلية باسم config.json.pre-split.bak قبل لمسه. كل شيء آخر في config.json يُترك تمامًا كما كان، بما في ذلك ترتيب المفاتيح.

أول تشغيل: ينشئ hate_crack كلا الملفين لك، فلا يوجد ما تفعله. لإعداد .env يدويًا بدلاً من ذلك، انسخ القالب المتتبع:```bash cp .env.example .env chmod 600 .env

`.env.example` يتم الالتزام به في المستودع ويُشحن وكل مفاتيح الاعتماد فيه فارغة. أما `.env` نفسه فيجب **أبدًا** عدم الالتزام به — فهو مستبعد عبر git، إلى جانب تهجئاته الاحتياطية المعتادة، ودائمًا ما ينشئه hate_crack بوضع `0600` (قراءة/كتابة للمالك فقط). يتم توليد `.env.example` من المخطط؛ أعد توليده بعد تغيير `hate_crack/config_schema.py` باستخدام `uv run python -m hate_crack.config_writer`.

### 3. تثبيت التبعيات و hate_crack

أسهل طريقة هي تشغيل `make` (أو `make install`)، الذي يكتشف نظام التشغيل لديك تلقائيًا ويقوم بتثبيت:
- التبعيات الخارجية (p7zip, transmission-daemon / transmission-remote)
- بناء الوحدات الفرعية (hashcat-utils, princeprocessor, pcfg_cracker, واختياريًا omen) ويسحب مجموعة أقنعة Corporate_Masks الخاصة بالبيانات فقط
- تبعيات Python عبر uv وواجهة CLI في `~/.local/bin/hate_crack````bash
make

هذه العملية غير قابلة للتكرار بشكل ضار - فهي تتخطى الأدوات المثبتة بالفعل. لإجبار إعادة تثبيت نظيفة:```bash make reinstall

**أو قم بتثبيت التبعيات يدويًا:**

### التبعيات الخارجية
هذه مطلوبة لبعض عمليات التنزيل/الاستخراج:

- `7z`/`7za` (p7zip) — تُستخدم لاستخراج أرشيفات `.7z`.
- `transmission-daemon` / `transmission-remote` — تُستخدم لتنزيل تورنتات Weakpass.

أوامر التثبيت اليدوي:

Ubuntu/Kali:```bash
sudo apt-get update
sudo apt-get install -y p7zip-full transmission-daemon

macOS (Homebrew):```bash brew install p7zip transmission-cli # provides transmission-daemon and transmission-remote

ثم قم بتثبيت تبعيات Python وواجهة الأوامر CLI:```bash
uv sync
mkdir -p ~/.local/bin
printf '#!/usr/bin/env bash\nset -euo pipefail\nexec uv run --directory %s python -m hate_crack "$@"\n' "$(pwd)" > ~/.local/bin/hate_crack
chmod +x ~/.local/bin/hate_crack

هيكل المشروع

أصبح المنطق الأساسي مقسّماً الآن إلى وحدات تحت hate_crack/:

• hate_crack/cli.py: أدوات argparse وتجاوزات الإعدادات.
• hate_crack/api.py: تكاملات Hashview وWeakpass وHashmob (التنزيلات/القوائم/المساعدات).
• hate_crack/attacks.py: معالجات هجمات القوائم.
• hate_crack/corpus_stats.py: إحصائيات كلمات المرور على مستوى المجموعة الكاملة المستخدمة لوصف المجموعة إلى LLM.
• hate_crack/plaintext.py: يستعيد كلمة المرور من سطر المجموعة (إزالة بادئة التجزئة، فك ترميز $HEX[...])؛ مشترك بين أوضاع LLM وcorpus_stats وrulegen.
• hate_crack/llm.py: توليد مرشحات LLM منظمة (JSON) عبر Atomic Agents.
• hate_crack/menu.py: عارض قوائم مشترك، بما في ذلك التنقل الاختياري بمفاتيح الأسهم.
• hate_crack/noninteractive.py: موزّع لأوامر الهجوم النصية.
• hate_crack/notify/: حزمة الإشعارات (خلفية Pushover، متتبع لكل عملية كسر).
• hate_crack/username_detect.py: يكتشف ملفات الإدخال بصيغة username:hash لتحديد خيار --username في hashcat.
• hate_crack/formatting.py وhate_crack/progress.py: مساعدات تنسيق المخرجات وعرض التقدم.
• hate_crack/main.py: التنفيذ الرئيسي لواجهة الأوامر.

يبقى الملف الرئيسي hate_crack.py في المستوى الأعلى كنقطة الدخول الرئيسية ويقوم بتنسيق هذه الوحدات.

المراجع والشكر

يعتمد هذا المشروع على عدد من المشاريع والخدمات الخارجية ويستلهم منها. شكراً إلى:

• Hashview (http://github.com/hashview/)
• Weakpass (https://weakpass.com)
• Hashmob (https://hashmob.net)

الاستخدام

بعد التثبيت باستخدام make، شغّل hate_crack من أي مكان:```bash hate_crack

or with arguments:

hate_crack <hash_file> <hash_type> [options]

بدلاً من ذلك، يمكنك التشغيل عبر `uv`:```bash
uv run hate_crack.py <hash_file> <hash_type>

التشغيل كأداة (موصى به)

قم بالتثبيت باستخدام make من جذر المستودع - وهذا يبني الوحدات الفرعية ويجمع الأصول:```bash cd /path/to/hate_crack make hate_crack

أمر `make install` ينشئ غلاف bash في `~/.local/bin/hate_crack` يعمل من دليل المستودع، بحيث يتم دائمًا العثور على الإعدادات والملفات المساعدة بغض النظر عن دليل العمل الحالي لديك.

يتم أيضًا البحث عن الإعدادات في:
- جذر المستودع ودليل الحزمة
- `~/.hate_crack`

**ملاحظة:** حقل `hcatPath` في `config.json` مخصص لموقع ملف hashcat الثنائي فقط (اختياري إذا كان hashcat في PATH). يتم تحميل ملفات Hate_crack المساعدة (hashcat-utils، princeprocessor، pcfg_cracker، Corporate_Masks، omen) من دليل المستودع ويتم تضمينها تلقائيًا بواسطة `make install`.

### التشغيل كسكربت
يستخدم السكربت سطر shebang خاص بـ `uv`. اجعله قابلاً للتنفيذ ثم شغّله:```bash
chmod +x hate_crack.py
./hate_crack.py

يمكنك أيضًا استخدام بايثون مباشرةً:```bash python hate_crack.py

### الاستخدام غير التفاعلي / عبر السكربتات

للأتمتة، يمكنك تشغيل هجوم واحد مباشرة، متجاوزًا القائمة. اسم الهجوم هو الوسيط الأول، يليه ملف التجزئة ونوع تجزئة hashcat. تُقبل مطالبات المعالجة المسبقة (تصفية حسابات الكمبيوتر، القوة العمياء بـ LM أولاً، إزالة تكرار الحسابات المكررة) تلقائيًا بقيمها الافتراضية في هذا الوضع. تخرج العملية برمز `0` عند النجاح ورمز غير صفري عند الخطأ (ملف تجزئة مفقود، نوع تجزئة غير رقمي، قائمة كلمات مفقودة، أو اسم ملف قاعدة غير معروف).```bash
# Quick crack: one wordlist + optional rule(s) from the rules directory
hate_crack quick hashes.txt 1000 --wordlist rockyou.txt --rules best64.rule

# Chain two rules in a single run
hate_crack quick hashes.txt 1000 --wordlist rockyou.txt --rules best64.rule+d3ad0ne.rule

# Run two rules as two separate passes
hate_crack quick hashes.txt 1000 --wordlist rockyou.txt --rules best64.rule d3ad0ne.rule

# Canned dictionary methodology (uses your configured wordlists)
hate_crack dict hashes.txt 1000

# Brute force lengths 1-8
hate_crack brute hashes.txt 1000 --min 1 --max 8

# Top-mask attack targeting ~4 hours
hate_crack topmask hashes.txt 1000 --target-time 4

استكشاف الأخطاء وإصلاحها

الخطأ: "would clobber existing tag" عند التحديث

يمكن أن يرفض استنساخ أقدم التحديث، مع طباعة قائمة طويلة من الأسطر مثل:``` ! [rejected] v2.5.0 -> v2.5.0 (would clobber existing tag)

هذا يؤثر على النسخ المستنسخة التي أُنشئت قبل يوليو 2026. أُعيدت كتابة التاريخ المنشور
آنذاك لإزالة بعض الملفات التي لم يكن ينبغي أبدًا إيداعها، مما أعطى
كل إيداع معرّفًا جديدًا؛ لذلك تشير وسوم النسخة المستنسخة الأقدم إلى كائنات
لم يعد هذا المستودع يحتوي عليها، ويرفض git نقل وسم يمتلكه بالفعل.
لا يوجد خطأ في نسختك المحلية ولا توجد بيانات تكسير معرضة للخطر.

استعد بإعادة تعيين لمرة واحدة. يؤدي هذا إلى تجاهل الإيداعات والتعديلات المحلية في
النسخة، لذا إذا كنت قد خصصت أي شيء يتتبعه git (على عكس
`config.json`، الذي لا يتم تتبعه)، فقم بإيداعه في فرع أولاً:```bash
cd /path/to/hate_crack
git fetch --tags --force origin
git checkout -B main origin/main
make install

--force هنا يقوم فقط بتحديث الوسوم؛ ولا يمكنه لمس عمليات الالتزام (commits) الخاصة بك. بعد ذلك، يعمل المحدّث المدمج بشكل طبيعي. الإصدارات قبل 2.18 لم تكن قادرة على تنفيذ هذا الاسترداد بنفسها، ولهذا السبب يجب القيام به يدويًا مرة واحدة.

خطأ: دليل البناء غير موجود

إذا رأيت خطأً مثل:``` Error: Build directory /opt/hashcat/hashcat-utils does not exist. Expected to find expander at /opt/hashcat/hashcat-utils/bin/expander.

هذا يعني أن أصول hate_crack لم تُضمَّن في الحزمة المثبَّتة.

**فهم المسارات:**
- `hcatPath` في config.json → يشير إلى **موقع ثنائي hashcat** (اختياري، يمكن أن يكون في PATH)
- `hashcat-utils/` و `princeprocessor/` → يتم تضمينهما في الحزمة عبر `make install`

**الحل:**
أعد التثبيت باستخدام Makefile، الذي يبني الوحدات الفرعية ويُثبّت الأداة:```bash
cd /path/to/hate_crack  # the repository checkout
make install

التكوين الافتراضي (config.json.example):

يمكن لمعظم المستخدمين استخدام الإعدادات الافتراضية دون تخصيص:

• hcatWordlists: ./wordlists (نسبي إلى جذر المستودع أو HOME/.hate_crack)
• hcatOptimizedWordlists: ./optimized_wordlists (دليل يُستخدم بواسطة Quick Crack؛ يتراجع إلى hcatWordlists إذا لم يُعثر عليه)
• rules_directory: ./hashcat/rules (يتضمن قواعد الوحدة الفرعية)
• hcatTuning: `` (سلسلة فارغة - لا توجد علامات ضبط افتراضية)

مثال على تخصيصات config.json:```json { "hcatPath": "/usr/local/bin", # Location of hashcat binary (optional, auto-detected from PATH) "hcatBin": "hashcat", # Hashcat binary name "hcatWordlists": "./wordlists", # Dictionary wordlist directory (relative or absolute) "rules_directory": "./hashcat/rules", # Rules directory (relative or absolute) "hcatTuning": "", # Additional hashcat flags (empty by default) ... }

**تحميل الإعدادات:**
- الأولوية لكل مفتاح: `os.environ` > ملف المنزل الخاص بذلك المفتاح (`.env` أو `config.json`) > القيمة الافتراضية المدمجة
- المفاتيح المفقودة تعود إلى القيم الافتراضية المدمجة؛ `config.json.example` يوثّق كل مفتاح في `config.json`
- يتم البحث في كلا الملفين، بشكل مستقل عن بعضهما البعض، بهذا الترتيب: **جذر المستودع**، ثم **دليل الحزمة المثبّتة**، ثم **`~/.hate_crack`**. أول تطابق يفوز؛ ومن الطبيعي أن يأتي الملفان من دليلين مختلفين.
- عند التشغيل الأول، يتم إنشاء كليهما — `config.json` من `config.json.example`، و`.env` من القيم الافتراضية المدمجة. إذا كان `config.json` قديمًا لا يزال يحتفظ بمفاتيح التكامل، يتم نسخها إلى `.env` الجديد ويخبرك hate_crack أي منها يجب حذفه من `config.json`؛ ولا يقوم أبدًا بتحرير ذلك الملف بنفسه.
- في كل تشغيل، يطبع hate_crack الملفين اللذين حمّلهما فعليًا:  ```
  [*] config.json: /home/you/.hate_crack/config.json
  [*] .env:        /home/you/.hate_crack/.env

اقرأ هذين السطرين قبل تصحيح إعداد "لا يسري مفعوله". إنهما موجودان بسبب فخّين في ترتيب البحث:

• نسخة مستنسخة (checkout) تتفوق على دليل منزلك. يتم البحث في جذر المستودع أولاً، لذا فإن ملف .env أو config.json الموجود في أي نسخة مستنسخة تشغّل الأداة منها يتغلب على الملف الموجود في ~/.hate_crack — وتشغيل الأداة من نسخة مستنسخة هو بالضبط ما ينشئ تلك الملفات هناك في المقام الأول. إذا حجب هذا إعداد ~/.hate_crack حقيقياً، فإن hate_crack يخبرك الآن بذلك عبر سطر [!] ثالث يسمّي كلا المسارين — تعامل مع ذلك السطر على أنه "الملف أدناه يتم تجاهله"، وليس كإعداد ثانٍ صالح بنفس القدر.
• لا يتم البحث في دليل العمل الحالي أبداً. يتم تجاهل ملف .env الموجود في الدليل الذي تقف فيه حالياً، عن قصد: أدلة المهام (engagements) مليئة بملفات لم يقصد أحد أن تكون إعدادات. ضعه في جذر المستودع أو في ~/.hate_crack.

خطأ: دمج مع المرجع 'refs/heads/master' لكن لم يتم جلب مثل هذا المرجع

إذا رأيت:``` Your configuration specifies to merge with the ref 'refs/heads/master' from the remote, but no such ref was fetched.

تمت إعادة تسمية الفرع الافتراضي من `master` إلى `main`. أصلح ذلك باستخدام:```bash
git remote set-head origin -a
git branch -m master main
git branch --set-upstream-to=origin/main main
git pull

أهداف Makefile

الافتراضي (التثبيت الكامل) - يبني الوحدات الفرعية، ويثبّت التبعيات، ويثبّت الأداة:```bash make

or explicitly:

make install

هذه العملية تكرارية (idempotent) - فهي تتخطى الأدوات المثبتة بالفعل.

**إعادة تثبيت نظيفة إجبارية:**```bash
make reinstall

تحديث سريع - يعيد بناء الوحدات الفرعية ويعيد تثبيت الأداة (بعد سحب التغييرات):```bash make update

**إلغاء التثبيت** - يزيل تبعيات نظام التشغيل والأداة:```bash
make uninstall

بناء hashcat-utils فقط:```bash make hashcat-utils

**تشغيل الاختبارات** - يتعامل تلقائيًا مع HATE_CRACK_SKIP_INIT عند الحاجة:```bash
make test

تقرير التغطية:```bash make coverage

**تنظيف نتائج البناء/الاختبار:**```bash
make clean

التطوير

إعداد بيئة التطوير

قم بتثبيت المشروع مع الاعتماديات الاختيارية للتطوير (تشمل أدوات الفحص والاختبار):```bash make dev-install

### تشغيل أدوات الفحص والتحقق من الأنواع

قبل دفع التغييرات، قم بتشغيل هذه الفحوصات محليًا. استخدم `make lint` لكل شيء، أو قم بتشغيل الفحوصات الفردية:

**Ruff (الفحص والتنسيق):**```bash
make ruff
# or manually:
uv run ruff check hate_crack tests tools packaging hate_crack.py

تلقائيًا إصلاح المشكلات:```bash uv run ruff format hate_crack tests tools packaging hate_crack.py uv run ruff check --fix hate_crack tests tools packaging hate_crack.py

**ty (فحص الأنواع):**```bash
make ty
# or manually:
uv run ty check hate_crack

تشغيل جميع الفحوصات معًا:```bash make lint

### تشغيل الاختبارات

تكتشف الاختبارات تلقائيًا عندما لا تكون الوحدات الفرعية مبنية وتقوم بتعيين `HATE_CRACK_SKIP_INIT=1` تلقائيًا.```bash
make test

أو قم بتشغيل pytest مباشرة:```bash uv run pytest -v

مع التغطية:```bash
make coverage

أو باستخدام pytest:```bash uv run pytest --cov=hate_crack

### خطافات Git (prek)

تُدار خطافات Git بواسطة [prek](https://github.com/j178/prek) (الإصدار 0.3.3+). ثبّت الخطافات باستخدام:```bash
prek install --hook-type pre-push --hook-type pre-commit

هذا يقوم بتثبيت الخطافات المعرّفة في prek.toml باستخدام مخطط pre-commit للمستودع المحلي:

• pre-push (خطافات محلية): ruff، ruff-format، ty، pytest، pytest-lima، bandit
• pre-commit (من pre-commit/pre-commit-hooks): trailing-whitespace، end-of-file-fixer، check-yaml، check-merge-conflict، check-added-large-files، detect-private-key

تقوم أدوات الإصلاح التلقائي في pre-commit بإعادة كتابة الملفات في مكانها، لذا أعد الترحيل (re-stage) ثم نفّذ الالتزام (commit) مرة أخرى بعد تشغيلها.

ملاحظة: يتوقع prek 0.3.3 وجود repos = [...] في المستوى الأعلى. الصيغة القديمة [hooks.<stage>] commands = [...] غير مدعومة.

التنقل في القوائم باستخدام أسهم لوحة المفاتيح

تستخدم القوائم افتراضيًا الترقيم الكلاسيكي عبر print() + input() للاختيار، والذي يقبل المفاتيح متعددة الأرقام بالكامل.

لتفعيل التنقل بأسهم لوحة المفاتيح عبر simple-term-menu، عيّن HATE_CRACK_ARROW_MENU=1. في هذا الوضع تعمل مفاتيح الاختصار ذات الرقم الواحد فقط؛ أما الخيارات المرقّمة 10 وما فوق فيجب الوصول إليها بأسهم لوحة المفاتيح. يتطلب وضع الأسهم أيضًا طرفية (TTY)، لذا يبقى معطّلًا عند توجيه المخرجات إلى أنبوب (pipe).

التبعيات الخاصة بالتطوير

تتضمن مجموعة [dev] الاختيارية:

• ty - مدقق الأنواع الثابتة
• ruff - مدقق ومهيئ Python سريع
• pytest - إطار عمل الاختبارات
• pytest-cov - تقارير التغطية

الخيارات الشائعة:

• --download-hashview: تنزيل التجزئات من Hashview قبل الكسر.
• --hashview: قائمة Hashview تفاعلية لإدارة التجزئات وقوائم الكلمات والمهام.
• --hashview --help: عرض خيارات سطر الأوامر الخاصة بـ Hashview.
• --weakpass: تنزيل قوائم الكلمات من Weakpass.
• --hashmob: تنزيل قوائم الكلمات من Hashmob.net.
• --hashmob-masks: تنزيل الأقنعة من Hashmob.net.
• --download-torrent <FILENAME>: تنزيل ملف تورنت محدد من Weakpass.
• --download-all-torrents: تنزيل جميع ملفات تورنت Weakpass المتاحة من ذاكرة التخزين المؤقت.
• --wordlists-dir <PATH> / --optimized-wordlists-dir <PATH>: تجاوز أدلة قوائم الكلمات.
• --pipal-path <PATH>: تجاوز مسار pipal.
• --restore-potfile: إعادة بناء <hashfile>.out من ملف POT الخاص بـ hashcat عند بدء التشغيل، مع استبدال أي محتويات موجودة، ثم المتابعة إلى القائمة العادية. بدون هذا العلم، يتم البحث في POT فقط عندما لا يكون ملف .out موجودًا بالفعل. يقوم خيار القائمة 93 بنفس الشيء عند الطلب، مع مطالبة تأكيد.
• --maxruntime <SECONDS>: تجاوز الحد الأقصى لوقت التشغيل.
• --bandrel-basewords <PATH>: تجاوز ملف الكلمات الأساسية bandrel.
• --update: التحديث إلى أحدث إصدار وإعادة التثبيت. يبدّل الفرع إلى main إذا كان على فرع آخر، لأن وسوم الإصدارات موجودة هناك.
• --nightly: التحديث إلى أحدث إصدار ليلي بدلاً من ذلك، من فرع nightly-dev. الإصدارات الليلية اجتازت CI لكنها ليست جزءًا من إصدار مقطوع. يمكن كتابتها أيضًا كـ --update --nightly.
• --no-optimized-kernel (أو --no-optimize): عدم تمرير -O إلى hashcat أبدًا طوال التشغيل. يتجاوز optimizedKernelAttacks في config.json ويزيل أي -O تضعه في hcatTuning. لا يُكتب أي شيء مرة أخرى إلى الإعدادات، لذا ينطبق هذا على هذا التشغيل فقط. مع أمر فرعي، ضعه قبل الأمر الفرعي: ./hate_crack.py --no-optimize quick hashes.txt 1000 --wordlist words.txt.
• --debug: تفعيل تسجيل التصحيح (يكتب إلى stderr).

تكامل Hashview

يتكامل hate_crack مع Hashview لإدارة التجزئات المركزية والكسر الموزّع.

القائمة التفاعلية

الوصول إلى قائمة Hashview التفاعلية:```bash hate_crack.py --hashview

خيارات القائمة:
- **(1) رفع التجزئات المُخترقة** - رفع نتائج الاختراق من الجلسة الحالية إلى Hashview
- **(2) رفع قائمة كلمات** - رفع ملف قائمة كلمات إلى Hashview
- **(3) تنزيل قائمة كلمات** - تنزيل قائمة كلمات من Hashview
- **تنزيل قاعدة** - تنزيل ملف قواعد من Hashview (مفكوك الضغط إلى نص عادي، جاهز لـ `hashcat -r`)
- **تنزيل جميع القواعد** - تنزيل كل ملف قواعد مُدرج بواسطة Hashview في عملية واحدة؛ يتم الإبلاغ عن فشل كل قاعدة على حدة دون إيقاف البقية
- **(4) تنزيل التجزئات المتبقية** - تنزيل التجزئات غير المُخترقة المتبقية (يطلب التبديل للاختراق)
- **(5) تنزيل التجزئات المُكتشفة** - تنزيل التجزئات المُخترقة بالفعل مع كلمات المرور النصية الصريحة (للرجوع إليها/للتحليل)
- **(6) رفع ملف تجزئات وإنشاء مهمة** - رفع ملف تجزئات جديد وإنشاء مهمة اختراق
- **(99) العودة إلى القائمة الرئيسية** - العودة إلى القائمة الرئيسية

**مهم: تنزيل المُكتشفة مقابل تنزيل المتبقية**
- **تنزيل التجزئات المتبقية (4)**: تنزيل التجزئات غير المُخترقة التي تحتاج إلى اختراق. يتم دمجها تلقائيًا مع أي تجزئات مُكتشفة إذا كانت متوفرة، ويطلب التبديل إلى ملف التجزئات هذا للاختراق.
- **تنزيل التجزئات المُكتشفة (5)**: تنزيل التجزئات المُخترقة بالفعل بصيغة تجزئة:نص صريح. هذه للرجوع إليها فقط ولا يمكن اختراقها أكثر. لا يتم عرض طلب تبديل.

#### واجهة سطر الأوامر

يمكن أيضًا تنفيذ عمليات Hashview عبر سطر الأوامر:

رفع التجزئات المُخترقة:```bash
hate_crack.py --hashview upload-cracked --file <output_file>.out --hash-type 1000

ارفع قائمة كلمات:```bash hate_crack.py --hashview upload-wordlist --file .txt --name "My Wordlist"

حمّل ملف القواعد (محفوظًا وغير مضغوط، وجاهزًا لاستخدام `hashcat -r`):```bash
hate_crack.py --hashview download-rules --rules-id 4 --output best64.rule

تنزيل التجزئات المتبقية (تجزئات غير مكسورة للكسر):```bash hate_crack.py --hashview download-left --customer-id 1 --hashfile-id 123

تم تنزيل التجزئات الموجودة (التجزئات التي تم كسرها بالفعل مع النص الصريح):```bash
hate_crack.py --hashview download-found --customer-id 1 --hashfile-id 123

ارفع ملف الهاش وأنشئ المهمة:```bash hate_crack.py --hashview upload-hashfile-job --file hashes.txt --customer-id 1
--hash-type 1000 --job-name "NTLM Crack Job" --hashfile-name "Domain Hashes"

#### الإعدادات

قم بتعيين بيانات اعتماد Hashview في ملف `.env` (وهي إعدادات تكامل، لذا لا توجد في `config.json`):```
HASHVIEW_URL=https://hashview.example.com
HASHVIEW_API_KEY=your-api-key-here

تكوين LLM

هجوم LLM (الخيار 12) وهجوم قناع Rosetta (الخيار 23) يولّدان مرشحاتهما باستخدام نموذج محلي. قم بتكوين النموذج ونافذة السياق ومهلة الطلب في ملف .env:``` LLM_BACKEND=ollama OLLAMA_MODEL=qwen3:4b-instruct OLLAMA_NUM_CTX=8192 OLLAMA_TIMEOUT=300

**مفاتيح `OLLAMA_*` أدناه تنطبق على كل الخلفيات، وليس فقط Ollama.** إنها تحتفظ بهذه البادئة لأن `OLLAMA_HOST` هو نفس المتغير الذي يقرأه سطر أوامر Ollama نفسه، وإعادة تسميتها ستكسر كل ملف `.env` موجود دون أي فائدة وظيفية — فخادم vLLM أو خادم متوافق مع OpenAI يريد نفس المضيف والنموذج والمهلة والسياق ومقابض أخذ العينات تحت نفس الأسماء. `LLM_BACKEND` يحدد فقط كيفية تشكيل الطلب.

- **`OLLAMA_MODEL`** — نموذج Ollama المستخدم لتوليد المرشحات (الافتراضي: `qwen3:4b-instruct`). يستخدم هجوم LLM مخرجات منظمة (JSON)، لذا اختر نموذجًا يتمتع بدعم جيد للأدوات/JSON.
- **`OLLAMA_NUM_CTX`** — حجم نافذة السياق للنموذج (الافتراضي: `8192`). كان هذا `2048` قبل إدخال إحصائيات المجموعة، وهو صغير جدًا لاحتواء المطالبة المقدمة له: 500 نص عادي مُختار تعمل تقريبًا على 2,000–3,500 رمز قبل مطالبة النظام والاستجابة، لذا قام Ollama باقتطاع جزء من العينة التي وزعها آخذ العينات بعناية عبر الملف بصمت.
- **`OLLAMA_TIMEOUT`** — الثواني التي تنتظرها لاستجابة التوليد قبل الاستسلام (الافتراضي: `300`). ارفع هذا إذا كان نموذج كبير لا يزال يُحمَّل في VRAM عند الطلب الأول، والذي قد يتجاوز المهلة بخلاف ذلك؛ يطبع hate_crack المهلة المنقضية واسم هذا الإعداد عند حدوث ذلك.
- **`OLLAMA_MAX_SAMPLE_LINES`** — العتبة التي تحتها تقوم أوضاع LLM أيضًا بلصق النصوص العادية الحرفية في المطالبة (الافتراضي: `500`). القيم ≤ 0 تُعامل كـ 500.

  الأوضاع المشتقة من المجموعة (**قائمة الكلمات**، **كلمات المرور المكسورة**، **قواعد الأنماط**) تصف دائمًا *المجموعة بأكملها* إحصائيًا — حصص الكلمات الأساسية، الأقنعة، حالة الأحرف، الأطوال، الأرقام والرموز اللاحقة، السنوات — بدلاً من لصق شريحة منها. التجميع محدود، لذا فإن تفريغ 120,000 كلمة مرور يكلف تقريبًا نفس مساحة المطالبة مثل ملف من 500 سطر. عندما تتناسب المجموعة بأكملها تحت هذه العتبة، يتم تضمين النصوص العادية الخام أيضًا، حيث لا يُكسب شيء بإخفاء مجموعة صغيرة عن النموذج.

  هذا يستبدل السلوك السابق المتمثل في لصق عينة موزعة بالتساوي تصل إلى `ollamaMaxSampleLines` كلمة مرور. عينة من تفريغ كبير لم تنقل أي معلومات تردد على الإطلاق: لم يستطع النموذج التمييز بين كلمة أساسية يستخدمها 8% من المؤسسة وتلك التي يستخدمها شخص واحد، وهو بالضبط الإشارة التي تجعل التخمين جديرًا بالتنفيذ.
- **`OLLAMA_NO_CLOUD`** — عندما تكون `true`، ارفض إرسال أي شيء خارج هذا المضيف، لأي من خلفيات LLM الثلاث (Ollama، vLLM، أو خادم عام متوافق مع OpenAI). فحصان محكومان بهذا الإعداد الواحد: يقوم Ollama بتمرير نموذج موسوم بـ `-cloud` (`gpt-oss:120b-cloud`، `deepseek-v3.1:671b-cloud`) إلى ollama.com عبر نفس نقطة النهاية المحلية التي يستخدمها نموذج محلي، لذا لا يبدو أي شيء في الطلب مختلفًا — يتم رفض ذلك حسب اسم النموذج. يتم أيضًا فحص عنوان URL للخلفية المكوّنة: وجهة ليست حلقة استرجاع أو خاصة أو محلية الارتباط (وليست `localhost` أو اسم `.local`/`.internal`/`.lan`/`.localdomain`) تُرفض حسب الوجهة، واسم مضيف لا يمكن لهذا الفحص حله يُرفض أيضًا، مع فشل مغلق، بدلاً من السماح بمرور وجهة غير قابلة للتحقق. تحمل مطالبات hate_crack نصوصًا عادية مستردة وإحصائيات مجموعة واسم العميل وصناعته وموقعه، لذا فإن أي فحص يشتعل يعني رفض الطلب قبل بنائه. الافتراضي هو `false`، لذا يستمر نموذج سحابي أو خادم بعيد مُكوّن عمدًا في العمل؛ قم بتشغيله للمهام التي يجب ألا تغادر فيها بيانات العميل المضيف.
- **`OLLAMA_AUTO_RESEARCH`** — عندما تكون `true` (الافتراضي)، يطلب وضع **معلومات الهدف** من النموذج المحلي اقتراح الصناعة والموقع والشركة الأم / تاريخ الاستحواذ بمجرد كتابة اسم الشركة، ويقدمها كافتراضيات مطالبة قابلة للتحرير. اضبطها على `false` للحصول دائمًا على مطالبات فارغة (مفيد مع نموذج بطيء، حيث يكلف البحث رحلة ذهاب وإياب إضافية واحدة قبل بدء الهجوم).
- **`OLLAMA_HOST`** — حيث يستمع الخادم الخلفي المُكوّن. يقبل `host:port` بسيطًا (`theplague.lan:11434`) أو عنوان URL كاملًا بمخطط (`https://ollama.example.com`)؛ في كلتا الحالتين يتم تطبيع عنوان URL الأساسي قبل الاستخدام. الافتراضي هو `localhost:11434`، وهو منفذ Ollama — يحتاج خادم vLLM أو خادم متوافق مع OpenAI إلى تعيين هذا على منفذه الخاص (يستمع vLLM عادةً على `:8000`). اضبطه في `.env`، أو صدّره كمتغير بيئة حقيقي لتجاوزه لتشغيل واحد — إنه نفس اسم المتغير الذي يقرأه سطر أوامر Ollama نفسه.
- **`LLM_BACKEND`** — أي خادم متوافق مع OpenAI للتحدث معه: `ollama` (الافتراضي)، `vllm`، أو `openai` لخادم عام. يتحدث كل خادم خلفي نفس واجهة برمجة تطبيقات `/v1` لدردشة الإكمال، لذا يحدد هذا فقط تفصيلي تشكيل الطلب اللذين يختلفان فيهما: يحصل `ollama` على `options.num_ctx`، ويحصل `vllm` على `chat_template_kwargs={"thinking": false}` — وبدون ذلك يقوم خادم vLLM الذي يشغل محلل استدلال بتوجيه الاستجابة المنظمة بأكملها إلى `message.reasoning`، ويترك `message.content` فارغًا، ويكسر تحليل JSON. لا يرسل `openai` أيًا منهما، حيث لا يوجد مكافئ لـ `num_ctx` هناك. إنه **لا** يغير من أين تأتي إعدادات المضيف أو النموذج أو المهلة أو السياق أو أخذ العينات — تلك هي مفاتيح `OLLAMA_*` أعلاه لجميع الثلاثة.
- **`LLM_API_KEY`** — الاعتماد المرسل إلى الخادم الخلفي المُكوّن. الافتراضي هو الحرفي `ollama`، العنصر النائب الذي يتجاهله خادم Ollama نفسه، لذا تبقى طلبات التثبيت الحالي دون تغيير؛ القيمة الفارغة تعود إلى نفس العنصر النائب لأن OpenAI SDK يرفض `api_key=""`. اضبطها على القيمة الحقيقية إذا كان الخادم يفرض واحدة — خادم vLLM يبدأ بـ `--api-key` يعيد 401 بخلاف ذلك.
- تأكد من أن Ollama يعمل وأن النموذج مسحوب (`ollama pull qwen3:4b-instruct`) قبل استخدام هجوم LLM — لم يعد hate_crack يسحب النماذج المفقودة تلقائيًا.

يقدم الهجوم ثلاثة أوضاع توليد:

1. **معلومات الهدف** — الشركة / الصناعة / الموقع / الشركة الأم؛ يستمد النموذج المرشحات من تلك التفاصيل.

   بعد كتابة اسم الشركة، يسأل hate_crack نفس النموذج المحلي عما يعرفه بالفعل عن تلك المؤسسة ويملأ مسبقًا مطالبات **الصناعة** و**الموقع** و**الشركة الأم** بالإجابات، المعروضة بين قوسين:   ```
   Company name: Acme Rail Services

   [!] The values in parentheses below are the local model's GUESSES, not verified OSINT.
       Press Enter to accept, or type your own value to override.
   Industry (freight rail maintenance):
   Location (Omaha, Nebraska):
   Parent company / acquired by:

اضغط Enter لقبول الاقتراح أو اكتب فوقه. هذه القيم هي استرجاع النموذج، ليست OSINT — تعامل معها كنقطة بداية، وليست معلومات استخباراتية عن العميل. يستخدم البحث خادم Ollama المحلي فقط، لذا لا يغادر اسم العميل المضيف أبدًا؛ لا توجد استدعاءات ويب أو استدعاءات API من جهات خارجية. إذا لم يتعرف النموذج على المؤسسة (وهي الحالة الشائعة للعملاء الصغار)، فإنه لا يُرجع شيئًا وتحصل على مطالبات فارغة عادية: ``` Company name: Acme Rail Services Industry: Location: Parent company / acquired by:

فشل البحث — انتهاء المهلة، أو Ollama لا يعمل، أو إجابة فارغة — لا يمنع الهجوم أبدًا؛ بل يتراجع فقط إلى مطالبات فارغة. اضبط `ollamaAutoResearch` على `false` لتخطي البحث بالكامل.
2. **قائمة الكلمات** — اشتقاق الكلمات الأساسية من قائمة كلمات نموذجية.
3. **كلمات المرور المكسورة** — إعادة تغذية النصوص الصريحة التي تم استردادها بالفعل في هذه الجلسة (`<hashfile>.out`) إلى النموذج حتى يتمكن من استنتاج اصطلاحات كلمات المرور الخاصة بالمؤسسة المستهدفة (الكلمات الأساسية، الفصول، السنوات، اللواحق، leetspeak) وتوليد مرشحات *جديدة* بنفس الأسلوب. يُدرج هذا الخيار فقط بمجرد كسر تجزئة واحدة على الأقل؛ ويُحلل الملف بأكمله إحصائيًا تمامًا مثل وضع قائمة الكلمات (انظر `ollamaMaxSampleLines` أعلاه).

#### تكوين PCFG

يستخدم هجوم PCFG (الخيار 20) وهجوم PRINCE-LING (الخيار 21) الوحدة الفرعية `pcfg_cracker`. قم بتكوينها في `config.json`:```json
{
"pcfgRuleset": "DEFAULT",
"pcfgMaxCandidates": 50000000,
"pcfgPrinceLingMaxCandidates": 10000000
}

• pcfgRuleset — اسم القواعد النحوية المدربة للاستخدام (الافتراضي: DEFAULT)، ويُحل إلى pcfg_cracker/Rules/<name>/. درّب قواعدك الخاصة باستخدام trainer.py الخاص بـ pcfg_cracker واضبط هذا على اسم مجموعة القواعد.
• pcfgMaxCandidates — الحد الأقصى للمرشحين الذين يصدرهم pcfg_guesser.py لهجوم PCFG (الافتراضي: 50000000).
• pcfgPrinceLingMaxCandidates — الحد الأقصى للكلمات الأساسية التي يكتبها prince_ling.py في قائمة كلمات PRINCE الأساسية المخزنة مؤقتًا (الافتراضي: 10000000).

النوى المحسّنة (optimizedKernelAttacks)

علامة -O في hashcat تختار النوى المحسّنة، وهي أسرع بشكل ملحوظ لكنها تضع حدًا أقصى لطول المرشح (حوالي 31 حرفًا، وأقل لبعض الأوضاع) و تتخطى بصمت أي شيء أطول من ذلك. optimizedKernelAttacks في config.json يسرد الهجمات التي تعمل مع -O؛ احذف هجومًا من القائمة لتشغيله مع نوى كاملة الطول. القائمة في config.json.example تطابق الافتراضي المدمج الذي يُطبَّق عندما لا يوجد config.json.

أربعة هجمات تحترم الإعداد لكنها ليست محسّنة افتراضيًا، لأنها تغذي مرشحين قد يتجاوزون سقف -O — أضفها إلى القائمة لتفعيلها:

• hcatNgramX, hcatOllama, hcatOmen, hcatLMtoNT

لإيقاف -O في كل مكان لتشغيل واحد دون تعديل الإعدادات، مرّر --no-optimized-kernel (الصيغة المختصرة --no-optimize). إنه يتجاوز القائمة لكل هجوم ويزيل أيضًا -O المكتوب في hcatTuning، والذي سيصل إلى hashcat بخلاف ذلك بغض النظر عن القائمة.

تُطابق الأسماء بدقة، ويُبلَغ عن أي إدخال غير معروف عند بدء التشغيل بدلاً من تجاهله. لاحظ أن الهجمات التي تفوّض إلى هجوم آخر تتحكم فيها الهجمات التي تفوّض إليها، وليس اسمها الخاص: PRINCE-LING يتبع hcatPrince، بينما Spoonman وRosetta وأوضاع قواعد أنماط LLM تتبع hcatQuickDictionary.

تتبع تغطية الهجوم (coverage_enabled)

عبر مهمة طويلة، يتعرض نفس ملف التجزئة للهجوم في جلسات عديدة مع مجموعة متناوبة من قوائم الكلمات وملفات القواعد وقوائم الأقنعة، ومن السهل حرق ساعات في إعادة تشغيل أرض غطيتها بالفعل — خاصةً لأن نفس سطر القاعدة يعيش في أكثر من ملف قواعد واحد. يسجّل hate_crack ما شغّله بالفعل ضد كل ملف تجزئة ويعرض تخطي التداخل.

تُسجَّل التغطية لكل إدخال، وليس لكل ملف: أسطر قواعد فردية و أسطر .hcmask فردية، كل منها مقترن بقائمة الكلمات التي شُغّل ضدها. هذا هو ما يسمح له بالتعرف على أن ملف قواعد مخصص تشغّله اليوم يكرر 40 من القواعد التي غطاها best64.rule بالفعل الأسبوع الماضي، وهو أيضًا سبب أن القاعدة "مغطاة" فقط لقائمة الكلمات المحددة التي جُرّبت معها — نفس القواعد عبر مجموعة نصوص مختلفة تجرب مرشحين مختلفين تمامًا.

يُعرَّف ملف التجزئة بواسطة sha256 لمحتوياته، لذا تنجو التغطية من إعادة التسمية أو النقل بين الجلسات. تُعرَّف قوائم الكلمات بنفس الطريقة، مع حفظ الملخص مقابل الحجم ووقت التعديل بحيث يُجزَّأ نص ضخم متعدد الجيجابايت مرة واحدة بدلاً من كل هجوم.

لا يُطلب منك إلا عندما يكون هناك شيء يستحق التخطي فعلاً:``` [*] Coverage: 40 of 45 rules in this Dictionary have already been run against this hash file. [?] Skip them and run only the 5 new rules? [Y/n]:

أجب بـ `Y` وسيقوم hate_crack ببناء ملف قواعد مؤقت يحوي الإدخالات غير المجرّبة فقط؛
أجب بـ `n` لتشغيل العملية كاملة على أي حال. إذا كان *كل* إدخال مكررًا،
يُسأل عما إذا كنت تريد تخطي الهجوم كليًا، لذا فإن إعادة تشغيل مناطق مغطاة عمدًا
لا تتطلب أبدًا إعادة تشغيل الأداة.

الهجمات التي لا تتم تصفيتها أبدًا تُسجَّل على أنها نُفِّذت، وهذا ما
يتيح لك الإجابة على سؤال "هل شغّلت PRINCE بالفعل ضد هذا الهدف؟".

الهجوم الذي يختار عدة ملفات قواعد دفعة واحدة (Quick Crack، Loopback) يطرح
سؤال التخطي **مرة واحدة للدفعة بأكملها، مقدمًا**، قبل أي استدعاء لـ hashcat.
هذا السؤال متعمد أن يكون خفيفًا — فهو لا يقرأ أو يجزّئ أيًا من ملفات القواعد
المحددة، لأن دفعة YOLO قد تصل إلى ملايين الأسطر ولا ينبغي أن تنتظر ذلك
للإجابة بنعم/لا. يسأل المخزن فقط عما إذا كان هذا الهجوم قد نُفِّذ بالفعل ضد
ملف التجزئة هذا **مع إحدى قوائم الكلمات هذه**؛ الفرق لكل إدخال ما زال يحدث
بشكل كسول، ملف قواعد واحدًا في كل مرة، ويقرر ما الذي يُتخطى فعليًا.
لذا لا يتم وضع علامة على مجموعة بيانات جديدة أبدًا، حتى عندما تكون القواعد
المطبقة عليها قد نُفِّذت جميعها ضد مجموعة مختلفة.

ثلاثة حدود متعمدة:

- **يُسجَّل التغطية فقط عندما يستنفد hashcat مساحة المفاتيح** (خروج 1).
  لا يُسجَّل شيء عند ctrl-C أو خطأ، وكذلك لا يُسجَّل عند الخروج 0 — وهذا يعني
  أن كل تجزئة تم كسرها، وهو ما يبلغ عنه hashcat *دون* إنهاء مساحة المفاتيح،
  وفي الحالة المتدهورة "كل التجزئات وُجدت كإدخالات potfile" دون تجربة
  مرشح واحد. نقص التسجيل لا يكلف سوى تشغيلًا زائدًا لاحقًا.
- **مولّدات المرشحات الديناميكية لا تتم تصفيتها أبدًا.** PRINCE وPCFG وOMEN
  وMarkov brute force وأوضاع LLM ليس لها مجموعة ثابتة للمقارنة، لذا تُسجَّل
  على أنها نُفِّذت وتُترك وشأنها. ملفات القواعد المتسلسلة (`-r a -r b`)
  تُتتبع كوحدة واحدة بدلًا من كل إدخال، لأن hashcat يطبق *الجداء الديكارتي*
  للملفين وإسقاط سطر فردي سيزيل بصمت كل تركيبة شارك فيها.
- **تشغيلات `--loopback` تُسجَّل لكن لا تتم تصفيتها أبدًا.** يعيد hashcat
  النصوص الصريحة المكسورة حديثًا كمرشحات *إضافية*، لذا يحاول هذا التشغيل
  قائمة الكلمات الكاملة ومجموعة القواعد بالإضافة إلى ما تصل إليه تلك النصوص
  المعاد تدويرها. وهذا يجعل الاتجاهين غير متماثلين: تسجيله سليم، لذا يتم
  التعرف على تشغيل عادي لاحق لنفس قائمة الكلمات والقواعد بشكل صحيح كتكرار،
  لكن تشغيل loopback ثانٍ لديه المزيد من الكسور لإعادة تدويرها ولا يُتخطى أبدًا.

اضبط `coverage_enabled` على `false` في `config.json` لإيقاف هذا، أو مرّر
`--no-coverage` لتشغيل واحد — وهو لا يقرأ المخزن ولا يحدّثه.

#### فحص التغطية وإعادة تعيينها

خيار القائمة الرئيسية **85 — Attack Coverage** يعرض ما تم تشغيله ضد
ملف التجزئة المحمّل، وسجل تشغيله، ويمكنه مسحه. نفس الإجراءات الثلاثة
قابلة للبرمجة النصية:```bash
# What has already been run against this hash file?
hate_crack coverage status --hashfile hashes.txt

# Every attack that has run against it, oldest first
hate_crack coverage history --hashfile hashes.txt

# Start over for this hash file only (prompts unless --yes)
hate_crack coverage forget --hashfile hashes.txt --yes

يتم تحديد ملف التجزئة حسب المحتوى، لذا تعمل هذه الأمور بغض النظر عن مكان نقله منذ ذلك الحين. يؤثر forget على هذا الهدف الواحد فقط — حيث يتم تخزين السجل في ~/.hate_crack/coverage/attack_coverage.sqlite3، ويؤدي حذف الملف إلى إعادة تعيين التغطية لـ كل هدف.

عمليات التشغيل النصية

الهجوم النصي الذي تتخطاه التغطية بالكامل لا يزال يخرج برمز 0 افتراضيًا، لذا فإن تفعيل التغطية لا يمكن أن يبدأ في إفشال بيئة عمل قائمة. مرر --exit-code-on-skip للحصول على رمز الخروج 3 بدلاً من ذلك عندما لا يتم إطلاق أي شيء:```bash hate_crack --exit-code-on-skip hashes.txt dict

0 = ran, 1 = bad input, 2 = unknown command, 3 = everything was already covered

الخروج برمز 3 يعني أن *لا شيء* تم تشغيله. عملية فحص تمت تصفيتها جزئيًا — بعض الإدخالات تم تخطيها، وبعضها تمت محاولته — لا تزال تخرج برمز `0`، لأن الهجوم قام بعمل فعلي.

### الإشعارات (خيار القائمة 82)

يمكن لـ hate_crack إرسال إشعارات Pushover عند اكتمال الهجمات، وبشكل اختياري، عند كسر تجزئات فردية. جميع عناصر التحكم موجودة تحت خيار القائمة الرئيسية `82 — الإشعارات`:

1. **تبديل إشعارات Pushover [تشغيل/إيقاف]** — المفتاح الرئيسي. يُحفظ في `config.json` كـ `notify_enabled`.
2. **تبديل إشعارات كل كسر [تشغيل/إيقاف]** — عند التشغيل، يقوم متتبع خلفي بمراقبة ملف `.out` ويدفع إشعارًا لكل كسر (مع تجميع الدفعات لكل نبضة). يُحفظ في `config.json` كـ `notify_per_crack_enabled`. لا يمكن تفعيله بينما المفتاح الرئيسي في وضع إيقاف — فعّل الخيار 1 أولاً.
3. **إرسال إشعار Pushover تجريبي** — يرسل إشعارًا جاهزًا لتتمكن من التأكد من أن زوج رمز/مستخدم Pushover الخاص بك يعمل. يعمل حتى عندما يكون المفتاح الرئيسي في وضع إيقاف.

توجد بيانات الاعتماد في `.env`؛ أما مقابض الضبط المتبقية فهي خاصة بملف الإعدادات فقط في `config.json`:

- `NOTIFY_PUSHOVER_TOKEN`, `NOTIFY_PUSHOVER_USER` (في `.env`) — مطلوبة لأي إشعار ليتم إرساله. لا شيء في القائمة يكتب هذه القيم؛ عدّل `.env` بنفسك.
- `notify_attack_allowlist` — أسماء الهجمات التي توافق تلقائيًا دون مطالبة `[y/N/always]`. تُملأ تلقائيًا عندما تجيب بـ `always`.
- `notify_suppress_in_orchestrators` (الافتراضي `true`) — يكتم الهجمات الفردية المتسلسلة بواسطة Extensive Crack، الذي يرسل ملخصًا واحدًا بدلاً من ذلك. اضبطه على `false` للحصول على إشعار لكل هجوم متسلسل. إدخالات القائمة الأخرى التي تشغّل عدة عمليات فحص (مثل Quick Crack مع سلاسل قواعد متعددة) ليست منسّقة وتُشعر دائمًا لكل عملية فحص.
- `notify_max_cracks_per_burst` (الافتراضي `5`), `notify_poll_interval_seconds` (الافتراضي `5.0`) — ضبط المتتبع لكل كسر. راجع `hate_crack/notify/tailer.py` لمنطق تجميع الدفعات.

### أدوات قوائم الكلمات (خيار القائمة 80)

توفر القائمة الفرعية لأدوات قوائم الكلمات أدوات معالجة مسبقة لقوائم الكلمات مدعومة بثنائيات hashcat-utils، بالإضافة إلى تنزيلات قوائم الكلمات من Hashmob.net وWeakpass. الوصول عبر الخيار **80** في القائمة الرئيسية.

| الخيار | الثنائي | ما يفعله |
|--------|--------|--------------|
| 1 | `len.bin` | تصفية حسب الطول — الاحتفاظ فقط بالكلمات بين حد أدنى وحد أقصى للطول |
| 2 | `req-include.bin` | طلب فئات الأحرف — الاحتفاظ فقط بالكلمات التي تحتوي على جميع أنواع الأحرف المطلوبة |
| 3 | `req-exclude.bin` | استبعاد فئات الأحرف — إزالة الكلمات التي تحتوي على أي نوع أحرف مستبعد |
| 4 | `cutb.bin` | استخراج سلسلة فرعية — قص نطاق بايتات من كل كلمة |
| 5 | `splitlen.bin` | تقسيم حسب الطول — إنشاء ملفات منفصلة لكل طول كلمة (ملفات مسماة `01`-`64` في دليل إخراج) |
| 6 | `rli.bin` / `rli2.bin` | طرح الكلمات — إزالة الإدخالات التي تظهر في ملف واحد أو أكثر من الملفات الأخرى |
| 7 | `gate.bin` | تقسيم — استخراج كل كلمة N-ثانية للتكسير الموزع عبر أجهزة متعددة |
| 8 | - | تحسين قوائم الكلمات — إزالة التكرارات والتقسيم إلى ملفات حسب الطول تحت دليل قوائم الكلمات المحسّنة |
| 9 | - | تنزيل قوائم الكلمات من Hashmob.net |
| 10 | - | تنزيل قوائم الكلمات من Weakpass (عبر BitTorrent) |

**بتات قناع فئات الأحرف** (المستخدمة في الخيارين 2 و3): `1`=أحرف صغيرة، `2`=أحرف كبيرة، `4`=رقم، `8`=رمز، `16`=أخرى. اجمع القيم معًا: `7` = أحرف صغيرة+أحرف كبيرة+رقم.

**كيف يُقصد استخدام التقسيم**: يقسم التقسيم قائمة كلمات واحدة إلى N أجزاء متساوية غير متداخلة بحيث يمكن توزيع العمل عبر أجهزة أو وحدات معالجة رسومية متعددة. كل جزء *متشابك* (كل سطر N-ثاني)، لذا فإن كل شريحة هي عينة تمثيلية من القائمة بأكملها بدلاً من كتلة متجاورة أمامية/خلفية — لا تعلق أي عقدة واحدة في تكسير الذيل منخفض الاحتمال فقط.

شغّل الخيار 7 مرة واحدة، وأعطه قائمة كلمات إدخال، ومسار أساسي للإخراج، وعدد الشرائح (N). يكتب جميع أجزاء N في تمريرة واحدة، مسماة بأرقام أجزاء محشوة بالأصفار (`base.001`, `base.002`, … حتى `base.00N`). انسخ جزءًا واحدًا إلى كل عقدة ووجّه تشغيل hashcat الخاص بتلك العقدة إليه. على نظام بوحدة معالجة رسومية واحدة لا يعطي التقسيم أي تسريع، لكن الجزء الواحد لا يزال عينة سريعة وتمثيلية لتمريرة فرز سريع قبل الالتزام بالقائمة الكاملة.

#### فحوصات التحديث التلقائي

يمكن لـ hate_crack التحقق تلقائيًا من GitHub بحثًا عن إصدارات أحدث عند بدء التشغيل. يتم التحكم في هذه الميزة بواسطة خيار الإعداد `check_for_updates`:```json
{
  "check_for_updates": true
}

• check_for_updates — تفعيل الفحص التلقائي للنسخ عند بدء التشغيل (الافتراضي: true).
• عند التفعيل، يقوم hate_crack بجلب أحدث معلومات الإصدار من GitHub ويعرض إشعارًا إذا كان هناك تحديث متاح.
• يعمل الفحص بشكل غير متزامن ولا يمنع بدء التشغيل. يتم تجاهل أخطاء الشبكة بصمت.

قنوات التحديث

تتبع الإصدارات نظام semver العادي، مع تحديد الزيادة بناءً على ما هو موجود فعليًا في الدفعة. المكوّن الثاني يتحرك فقط للميزات: دورة تحتوي على أي commit من نوع feat تتجه نحو X.(Y+1).0، ودورة لا تحتوي سوى على إصلاحات، وثائق، ومهام روتينية تتجه نحو X.Y.(Z+1).

علامات nightly-dev تُصدر مرشحات إصدار للنسخة التي تتجه إليها الدفعة — v2.20.1rc1، v2.20.1rc2، … — والدمج إلى main يرقّي نفس الهدف إلى إصداره النهائي. المرشحات هي إصدارات تجريبية حقيقية وفق PEP 440، لذا فهي تُرتّب بشكل صحيح في كلا الطرفين:

2.20.0  <  2.20.1rc1  <  2.20.1rc2  <  2.20.1  <  2.21.0rc1  <  2.21.0

يمكن أن يتغير الهدف في منتصف الدورة: أول feat يصل ينقله من X.Y.(Z+1) إلى X.(Y+1).0، ويُعاد ترقيم المرشحات للهدف الجديد. الرقم دائمًا يسمّي ما ستصدره الدفعة اليوم.

لا يتم رفع المكوّن الرئيسي تلقائيًا أبدًا — سطر موضوع يحتوي على ! أو تذييل BREAKING CHANGE: يُعتبر ميزة، لأن رفع رئيسي تلقائي يعني أن خطأً مطبعيًا في سطر الموضوع قد يؤدي إلى إصدار منشور لا يمكن التراجع عنه. الرقم الرئيسي هو فعل بشري صريح: قم بوضع العلامة ودفعه يدويًا.

توجد السياسة في tools/next_version.py، وتُشاركها كلتا سيرتي عمل وضع العلامات، ومُختبَرة بالوحدات في tests/test_next_version.py.

فحص بدء التشغيل يعرض الإصدارات الرسمية فقط، لأن البنيات الليلية لا تنشر أي إصدار GitHub على الإطلاق، والفحص يقرأ نقطة نهاية "أحدث إصدار" في GitHub — لذا تفعيل check_for_updates لن يجرّك أبدًا إلى نسخة ليلية. أمران يبقيان القناتين منفصلتين الآن: ذلك، وحقيقة أن المرشح هو إصدار تجريبي حقيقي وفق PEP 440، لذا فإن أي أداة ترتّب أرقام الإصدارات الخام تعامله أيضًا على أنه أقدم من الإصدار الذي يصبح عليه.

أي من العلامتين يحوّل نسختك المحلية إلى الفرع المقابل أولًا (ويرفض القيام بذلك إذا كانت لديك تغييرات غير ملتزمة). إذا كنت تشغّل نسخة ليلية وتريد العودة إلى الكود المنشور، فإن --update يعيدك إلى main.

الدمج التلقائي للتجزئات المكتشفة (تنزيل اليسار فقط)

عند تنزيل تجزئات اليسار (التجزئات غير المكسورة)، يقوم hate_crack تلقائيًا بما يلي:

1. محاولة تنزيل أي تجزئات مكتشفة (مكسورة) من Hashview كعملية مساعدة
2. دمج التجزئات المكتشفة مع ملفات .out المحلية (مثل left_1_123.txt.out أو left_1_123.nt.txt.out لتنسيق pwdump)
3. إزالة الإدخالات المكررة
4. تنظيف الملفات المؤقتة المقسمة بعد الدمج

يضمن هذا بقاء نتائج الكسر المحلية متزامنة مع قاعدة بيانات Hashview المركزية عند العمل مع التجزئات غير المكسورة.

ملاحظة: خيار تنزيل المكتشف يقوم بتنزيل التجزئات المكسورة بالفعل بشكل منفصل لأغراض مرجعية ولا يقوم بأي دمج أو يطلب الكسر.

يتم الحصول على <hash_type> بتشغيل hashcat --help

أمثلة على التجزئات: http://hashcat.net/wiki/doku.php?id=example_hashes``` $ hashcat --help |grep -i ntlm 5500 | NetNTLMv1 | Network protocols 5500 | NetNTLMv1 + ESS | Network protocols 5600 | NetNTLMv2 | Network protocols 1000 | NTLM | Operating-Systems

بعد اكتمال الفحص، سيعرض التقرير النتائج التفصيلية، بما في ذلك أي نقاط ضعف تم اكتشافها، ومستوى خطورتها، وتوصيات للإصلاح. يمكنك أيضًا تصدير التقرير بصيغ متعددة مثل HTML أو PDF أو JSON لمزيد من التحليل أو التوثيق.

لضمان نتائج دقيقة، تأكد من أن الأداة لديها الأذونات اللازمة للوصول إلى الأنظمة المستهدفة، وأن الشبكة تسمح بالاتصال بالمنافذ المطلوبة. إذا واجهت أي مشاكل في الاتصال، تحقق من إعدادات جدار الحماية أو قيود الشبكة التي قد تمنع الفحص.

بالإضافة إلى ذلك، يمكنك جدولة عمليات الفحص المنتظمة باستخدام cron أو أي أداة جدولة أخرى لأتمتة عملية التقييم الأمني وضمان بقاء بنيتك التحتية محمية بشكل مستمر.```
$ ./hate_crack.py <hash file> 1000

  ___ ___         __             _________                       __
 /   |   \_____ _/  |_  ____     \_   ___ \____________    ____ |  | __
/    ~    \__  \\   __\/ __ \    /    \  \/\_  __ \__  \ _/ ___\|  |/ /
\    Y    // __ \|  | \  ___/    \     \____|  | \// __ \\  \___|    <
 \___|_  /(____  /__|  \___  >____\______  /|__|  (____  /\___  >__|_ \
       \/      \/          \/_____/      \/            \/     \/     \/
                          Version 2.0

الاختبار

مجموعة الاختبارات غير متصلة بالإنترنت في الغالب وتستخدم النماذج الوهمية (mocks) والبيانات الثابتة (fixtures). فحوصات الشبكة المباشرة وفحوصات تبعيات النظام اختيارية ويتم تفعيلها عبر متغيرات البيئة.

تشغيل الاختبارات محليًا```bash

Run all tests

uv run pytest -v

Run specific test

uv run pytest tests/test_hashview.py -v

يمكنك أيضًا تشغيل مجموعة الاختبارات الكاملة باستخدام `make test`.

### الاختبارات المباشرة (الاشتراك الاختياري)

عيّن أيًا مما يلي لتفعيل الفحوصات المباشرة:

- `HASHMOB_TEST_REAL=1` — فحص اتصال Hashmob المباشر/قائمة CLI
- `HASHVIEW_TEST_REAL=1` — فحص قائمة CLI الخاصة بـ Hashview مباشرة
- `WEAKPASS_TEST_REAL=1` — فحص قائمة CLI الخاصة بـ Weakpass مباشرة
- `HATE_CRACK_REQUIRE_DEPS=1` — يفشل إذا كان `7z` أو `transmission-daemon` أو `transmission-remote` مفقودًا

### اختبار رفع Hashview المباشر

يتم تخطي اختبار رفع Hashview المباشر افتراضيًا. لتشغيله، عيّن
متغير البيئة وقدّم بيانات اعتماد صالحة في `.env`:```bash
HATE_CRACK_RUN_LIVE_TESTS=1 uv run pytest tests/test_upload_cracked_hashes.py -v

اختبارات Hashview المباشرة ضد حزمة Docker محلية

بدلاً من توجيه الاختبارات المباشرة إلى خادم Hashview بعيد، يمكنك جعل المجموعة تُشغّل حزمة Hashview Docker محلية، وتُهيّئها بالبيانات، وتُشغّل الاختبارات المباشرة ضدها، ثم تُزيلها. اضبط HASHVIEW_TEST_LOCAL=1 ووجّه HASHVIEW_REPO إلى نسخة Hashview:```bash HASHVIEW_TEST_LOCAL=1 HASHVIEW_REPO=~/projects/hashview
HATE_CRACK_SKIP_INIT=1 uv run pytest tests/test_hashview_cli_subcommands_subprocess.py -v

يقوم هذا بتشغيل `docker compose` في مستودع Hashview، ويُهيّئ مفتاح API للمسؤول،
وعميلاً، وملف تجزئة، وبيانات "المهمة الفعّالة" المكسورة، ثم يُصدّر
متغيرات البيئة `HASHVIEW_*` التي تقرأها الاختبارات. متغيرات البيئة المفيدة:

- `HASHVIEW_TEST_LOCAL=1` — لتفعيل الحزمة المحلية (لا تأثير لها بخلاف ذلك)
- `HASHVIEW_REPO=<path>` — مسار نسخة Hashview (الافتراضي `~/projects/hashview`)
- `HASHVIEW_KEEP=1` — لإبقاء الحاويات تعمل بعد الجلسة (إعادة تشغيل أسرع)
- `HASHVIEW_LOCAL_PORT=5000` — منفذ المضيف الذي يُنشر عليه التطبيق

يحترم واجهة سطر الأوامر hate_crack متغيرات البيئة `HASHVIEW_URL` / `HASHVIEW_API_KEY`
(متجاوزًا ملف `.env` الذي يحتوي هذين المفتاحين)، وهذا ما يسمح
للمجموعة بتوجيه واجهة سطر الأوامر إلى الحزمة المحلية دون تعديل إعداداتك المحفوظة.

### اختبارات التثبيت الشاملة (محلي + Docker)

تثبيت أداة uv محليًا وتنفيذ السكربت (يستخدم HOME مؤقتًا):```bash
HATE_CRACK_RUN_E2E=1 uv run pytest tests/test_e2e_local_install.py -v

Docker-based end-to-end install/run (cached via Dockerfile.test):```bash HATE_CRACK_RUN_DOCKER_TESTS=1 uv run pytest tests/test_docker_script_install.py -v

اختبار Docker E2E يقوم أيضًا بتنزيل مجموعة فرعية صغيرة من rockyou وتشغيل
عملية كسر أساسية باستخدام hashcat للتحقق من تكامل الأدوات الخارجية.

اختبار Lima VM الشامل (لنظام macOS فقط):

المتطلبات الأساسية: يجب تثبيت [Lima](https://lima-vm.io/) و`rsync`.```bash
brew install lima

يتم تجهيز جهاز الاختبار الافتراضي تلقائيًا بجميع تبعيات لينكس (hashcat، build-essential، curl، git، gzip، p7zip-full، transmission-daemon، ocl-icd-libopencl1، pocl-opencl-icd، uv).```bash HATE_CRACK_RUN_LIMA_TESTS=1 uv run pytest tests/test_lima_vm_install.py -v

هذا الاختبار يتحقق من التثبيت والتنفيذ داخل جهاز افتراضي خفيف بنظام Linux على macOS.

### بنية الاختبار

- **tests/test_hashview.py**: مجموعة اختبارات شاملة لفئة HashviewAPI مع استجابات API وهمية، بما في ذلك:
  - سرد العملاء والتحقق من البيانات
  - اختبارات المصادقة والتفويض
  - وظيفة رفع ملفات التجزئة
  - سير عمل إنشاء المهام الكامل

تستخدم جميع الاختبارات استدعاءات API وهمية، لذا يمكن تشغيلها دون اتصال بخادم Hashview.

-------------------------------------------------------------------

  (1) كسر سريع
  (2) كسر شامل بمنهجية Pure_Hate
  (3) هجوم القوة العمياء
  (4) هجوم القناع الأعلى
  (5) هجوم البصمة
  (6) هجمات الدمج
  (7) هجوم هجين
  (8) كسر القوة العمياء بأفضل 100 قناع من Pathwell
  (9) هجوم PRINCE
  (10) منهجية Bandrel
  (11) هجوم الحلقة العكسية
  (12) هجوم LLM
  (13) هجوم OMEN
  (14) هجوم القناع المخصص
  (15) هجوم القوة العمياء ماركوف
  (16) هجوم N-gram
  (17) هجوم التبديل
  (18) هجوم القواعد العشوائية
  (19) هجوم عبارة المرور Combipow
  (20) هجوم PCFG
  (21) هجوم PRINCE-LING
  (22) هجوم Spoonman
  (23) هجوم Rosetta
  (24) القوة العمياء بأقنعة الشركات
  (25) هجوم القناع الذكي

  (80) أدوات قوائم الكلمات
  (81) أدوات ملفات القواعد
  (82) الإشعارات
  (83) أدوات الأقنعة

  (93) إعادة إنشاء .out من ملف POT
  (94) واجهة برمجة تطبيقات Hashview
  (95) تحليل التجزئات باستخدام Pipal
  (96) تصدير النتائج إلى تنسيق Excel
  (97) عرض التجزئات المكسورة
  (98) عرض README
  (99) خروج

حدد مهمة:```

Option `94 — Hashview API` is only listed when `HASHVIEW_API_KEY` is set in `.env`.

The YOLO, Middle, and Thorough Combinator attacks were previously at keys 10-12. They now live in the Combinator Attacks submenu (option 6) along with Combinator3 and CombinatorX.
-------------------------------------------------------------------
#### Quick Crack
Runs a dictionary attack against wordlists in your `hcatOptimizedWordlists` directory (falls back to `hcatWordlists` if not configured) and optionally applies rules. Multiple rules can be selected by comma-separated list, and chains can be created with the '+' symbol. Pressing Enter at the wordlist prompt uses the configured optimized wordlists directory as the default.

Selecting a directory — including that default — expands to the wordlists
directly inside it before hashcat runs. Subdirectories are not searched,
matching hashcat's own behaviour for a directory in the dictionary position, and
dot-files and `.7z`/`.torrent`/`.out` files are skipped, which hashcat would
otherwise try to read. The candidates are the same either way; the expansion is
what lets attack coverage track each wordlist separately, since a directory has
no content fingerprint to key on. If the expansion finds nothing — an empty
directory, or one holding only subdirectories or archives — the attack aborts
rather than launching hashcat with no wordlist, which would put it in stdin
mode and leave it reading the terminal.

أي قاعدة (قواعد) تريد تشغيلها؟ (1) best64.rule (2) d3ad0ne.rule (3) T0XlC.rule (4) dive.rule (99) YOLO...شغّل جميع القواعد أدخل قائمة القواعد التي تريد تشغيلها مفصولة بفواصل. لتشغيل قواعد متسلسلة استخدم رمز +. على سبيل المثال 1+1 سيشغّل best64.rule مرتين متسلسلتين و1,2 سيشغّل best64.rule ثم d3ad0ne.rule بالتتابع. اختر بحكمة:```

Extensive Pure_Hate Methodology Crack

Runs several attack methods provided by Martin Bos (formerly known as pure_hate):

• Brute Force Attack (7 characters)
• Dictionary Attack
  • All wordlists in hcatWordlists with best64.rule
  • rockyou.txt with d3ad0ne.rule
  • rockyou.txt with T0XlC.rule
• Top Mask Attack (Target Time = 4 Hours)
• Fingerprint Attack
• Smart Mask Attack
• Combinator Attack
• Hybrid Attack
• Extra - Just For Good Measure
  • Runs a dictionary attack using rockyou.txt with chained combinator.rule and InsidePro-PasswordsPro.rule rules

Brute Force Attack

Brute forces all characters with the choice of a minimum and maximum password length.

Top Mask Attack

Uses StatsGen and MaskGen from PACK (https://thesprawl.org/projects/pack/) to perform a top mask attack using passwords already cracked for the current session. Presents the user a choice of target cracking time to spend (default 4 hours).

Fingerprint Attack

https://hashcat.net/wiki/doku.php?id=fingerprint_attack

Runs a fingerprint attack using passwords already cracked for the current session. Expander substring length escalates automatically (7, 14, 21, ... up to the chosen ceiling), and an optional wordlist can be combined against the expanded fragments in addition to self-combination. Set hcatFingerprintWordlist in config.json to a default wordlist path so the prompt offers it instead of asking for a path every time; leave it as "" to always ask (or skip).

Smart Mask Attack

Looks for literal "skeleton" patterns shared by 3+ already-cracked passwords for the current session -- e.g. a fixed stem like CrawlingHorse followed by a run of digits, or ChangeMe2day followed by digits and symbols drawn from a consistent charset. Every qualifying pattern runs against the full remaining hash list, so other accounts sharing a stem get swept up even though brute-forcing the stem itself was never tried.

Patterns with a fixed run at either end -- nearly all of them -- are grouped by mask and run as hybrid attacks (-a 6 when the mask trails the stem, -a 7 when it leads), with every pattern's literal stem a line in that group's wordlist. Dozens of patterns that vary the same way therefore become one hashcat pass over one wordlist rather than one mask line each. Whatever cannot be grouped that way -- variation at both ends, which leaves no fixed run to seed a wordlist with -- falls back to a single -a 3 mask file, and has its charsets widened (up to ?a) to compensate, as far as the guardrail below allows.

Prompts once, before the attack starts, for an optional per-pattern candidate-count guardrail (default 50,000,000,000; 0 disables it) that excludes any individual pattern whose keyspace is too large without blocking the rest.

Combinator Attack

https://hashcat.net/wiki/doku.php?id=combinator_attack

Runs a combinator attack using the "rockyou.txt" wordlist.

Hybrid Attack

https://hashcat.net/wiki/doku.php?id=hybrid_attack

• Runs sixteen hybrid passes per wordlist, cheapest first. Each mask length from 1 to 4 is tried appended and then prepended, first over ?s?d and then over ?a, and a single ctrl-C abandons the whole attack rather than only the current pass.

  • Hybrid Wordlist + Mask - ?s?d wordlists/rockyou.txt ?1
  • Hybrid Mask + Wordlist - ?s?d ?1 wordlists/rockyou.txt
  • ... the same for ?1?1, ?1?1?1 and ?1?1?1?1
  • Hybrid Wordlist + Mask - wordlists/rockyou.txt ?a
  • Hybrid Mask + Wordlist - ?a wordlists/rockyou.txt
  • ... the same for ?a?a, ?a?a?a and ?a?a?a?a

  ?a is every printable character, so the second group is a superset of the first plus letters and roughly 24x the work at the longest mask — over rockyou.txt those passes alone are ~1.2e15 candidates, about ten hours for NTLM on hardware doing 32 GH/s. That is why the cheap ?s?d group runs first and why the attack as a whole is time-bounded:

  • hcatHybridMaxRuntime in config.json, in seconds, default 3600, is the time the whole attack may spend — not the time one pass may spend. All sixteen passes share one deadline, and each is handed whatever is left of it as hashcat's --runtime. Any pass the budget does not reach is reported rather than skipped quietly. Set it to 0 for no limit, which runs every pass to exhaustion.

  Within each group the order is by mask length across every wordlist rather than all lengths of one wordlist and then the next, so a budget that runs out has still given every wordlist its cheap passes.

  Each pass declares what it covers to the attack-coverage store, so a repeat hybrid against the same hash file offers to skip the passes already run. A pass that runs out of budget is not recorded, so it will be retried. Wordlist entries may be glob patterns or directories; both are expanded before hashcat runs, a directory into the wordlists directly inside it. Subdirectories are not searched, matching hashcat's own behaviour, and dot-files and .7z/.torrent/.out files are skipped — a Weakpass download leaves archives in the wordlists directory and hashcat would otherwise try to read them.

Pathwell Top 100 Mask Brute Force Crack

Runs a brute force attack using the top 100 masks from KoreLogic: https://blog.korelogic.com/blog/2014/04/04/pathwell_topologies

PRINCE Attack

https://hashcat.net/events/p14-trondheim/prince-attack.pdf

Runs a PRINCE attack using wordlists/rockyou.txt

YOLO Combinator Attack

Runs a continuous combinator attack using random wordlists from the configured wordlists directory for the left and right sides.

Middle Combinator Attack

https://jeffh.net/2018/04/26/combinator_methods/

Runs a modified combinator attack adding a middle character mask: wordlists/rockyou.txt + masks + worklists/rockyou.txt

Where the masks are some of the most commonly used separator characters: 2 4 - _ , + . &

Thorough Combinator Attack

https://jeffh.net/2018/04/26/combinator_methods/

• Runs many rounds of different combinator attacks with the rockyou list.
  • Standard Combinator attack: rockyou.txt + rockyou.txt
  • Middle Combinator attack: rockyou.txt + ?n + rockyou.txt
  • Middle Combinator attack: rockyou.txt + ?s + rockyou.txt
  • End Combinator attack: rockyou.txt + rockyou.txt + ?n
  • End Combinator attack: rockyou.txt + rockyou.txt + ?s
  • Hybrid middle/end attack: rockyou.txt + ?n + rockyou.txt + ?n
  • Hybrid middle/end attack: rockyou.txt + ?s + rockyou.txt + ?s

Bandrel Methodology

Prompts for comma-separated names and creates a pseudo hybrid attack by capitalizing the first letter and adding up to six additional characters at the end. Each word is limited to a total of five minutes.

• Built-in common words (seasons, months) included as a customizable config.json entry (bandrel_common_basedwords)
• The default five-minute time limit is customizable via bandrelmaxruntime in config.json

Loopback Attack

https://hashcat.net/wiki/doku.php?id=loopback_attack

Uses hashcat's loopback mode to feed cracked passwords from the current session back into the attack pipeline with rules applied. This generates new password candidates based on variations of already-cracked passwords, which is particularly effective for finding related passwords that follow similar patterns.

• Prompts for rule selection to apply to the loopback candidates
• Uses an empty wordlist with the --loopback flag to process previously cracked passwords
• Automatically downloads Hashmob rules if no rules are available locally

LLM Attack

Uses a local LLM — Ollama by default, or a vLLM / OpenAI-compatible server via LLM_BACKEND — to generate password candidates for a capture-the-flag scenario. Prompts for the fake company name, industry, location, and parent company / acquisition history, then sends these details to the configured LLM model to produce likely password candidates using industry terms and company name permutations. The generated candidates are fed into a hashcat wordlist+rules attack.

• Requires a running server at OLLAMA_HOST (default: http://localhost:11434, Ollama's port; override in .env or the environment) already serving the model — hate_crack does not auto-pull
• Candidate generation uses structured (JSON) output via Atomic Agents, so pick a model with good schema adherence (default: qwen3:4b-instruct)
• Configurable backend, model, context window, request timeout, and sample size via .env (see LLM Configuration)
• Prompts for target company name, industry, location, and parent company / acquisition history. The industry, location, and parent company prompts are pre-filled with the local model's guesses about the named organization (editable, and clearly labelled as guesses rather than verified OSINT); disable with ollamaAutoResearch: false
• Alternatively derives basewords from a sample wordlist, or from the cracked passwords of the current session (<hashfile>.out) so the model mirrors the target organization's own password conventions and produces new candidates in that style (only offered once something has been cracked)
• A live spinner with an elapsed-seconds counter runs during generation, and requests are bounded by ollamaTimeout so a model stuck loading into VRAM reports a timeout instead of hanging

Pattern rules mode (option 4 in the LLM submenu) takes the same shape as the Spoonman Attack — a baseword list run through a rule file, both derived from one corpus — but infers each side with the model instead of extracting it. Spoonman is exact and therefore bounded: its basewords all appear in the corpus and its rules only reproduce transformations the corpus already shows. This asks the model to generalize on both axes, so it can name the word families behind a sample (the company and its products, site names, local sports teams, seasons, mascots) and write decorations the corpus does not contain.

• Pattern source is either the current session's cracked passwords (offered first, and only once something has been cracked, since those reveal the target's real conventions) or a sample wordlist
• You are not asked to pick a rule file. The model writes one, from the same corpus statistics — a stock rule file encodes the internet's habits, and the point of spending a model round trip is to encode this organization's
• Basewords are normalized to lowercase letters only, discarding anything under 3 characters, so the generated rules supply case, digits, and punctuation exactly once
• Generated rules are validated before hashcat sees them, and anything using an op hashcat does not have, a position argument outside 0-9A-Z, more than 31 functions, or a stray comment or non-ASCII character is discarded. hashcat drops an invalid rule silently when valid rules share the file, so an unscreened line would become missing coverage rather than an error. The op table was established by testing hashcat itself, not from its rule documentation, which lists ops hashcat will not actually run
• Local-model yield varies a lot run to run, so a thin answer is asked again once and the two rounds are merged — a handful of rules would waste the pass they are spent on
• If no rule survives validation the basewords still run, unmutated, rather than throwing away the expensive half of the run
• Output lands in <hashfile>.llm_patterns/ as basewords.txt and rules.rule — per-run scratch, laid out like .spoonman/ and removed on exit

OMEN Attack

Uses the Ordered Markov ENumerator (OMEN) to train a statistical password model from a wordlist and generate password candidates. This attack learns patterns from known passwords and generates new candidates based on those patterns.

• Requires OMEN binaries (createNG and enumNG) to be built from the omen submodule
• Interactive menu: use existing model, train new model, or cancel
• Training wordlist picker shows available wordlists from configured directory or accepts a custom path
• Validates all 5 required model files (createConfig, CP/IP/EP/LN.level) before running
• Captures and reports enumNG errors instead of failing silently
• Generates up to a specified number of password candidates (configurable via omenMaxCandidates)
• Pipes generated candidates directly into hashcat for cracking
• Model files and metadata are stored in ~/.hate_crack/omen/ for persistence across sessions

Combinator Attacks Submenu

Opens an interactive submenu with six combinator attack variants (formerly at menu keys 10-12). Consolidates related attacks for cleaner menu organization:

• Combinator Attack - combines two wordlists
• YOLO Combinator Attack - combines all permutations of multiple wordlists
• Middle Combinator Attack - combines wordlists with an extra word in the middle
• Thorough Combinator Attack - comprehensive combination of wordlists with rules
• Combinator3 Attack - combines exactly 3 wordlists using combinator3.bin, generating all word1+word2+word3 combinations piped to hashcat
• CombinatorX Attack - combines 2-8 wordlists using combinatorX.bin with optional --sepFill separator character between word segments

Ad-hoc Mask Attack

Runs hashcat mask attack (mode 3) with a user-specified custom mask string. Allows fine-grained control over character-set brute forcing.

• Opens with a choice between typing a mask and selecting a mask file
• Prompts for a hashcat mask (e.g., ?u?l?l?l?d?d for uppercase + lowercase + lowercase + lowercase + digit + digit)
• Supports custom character sets for specialized character combinations: -1 through -4 on any hashcat, plus -5 through -8 on hashcat 7 and newer. A mask using ?5–?8 against an older hashcat is flagged before the run rather than failing inside it; if the version cannot be read, the mask is passed through and hashcat decides
• Only prompts for the custom slots the mask actually references — ?1?3?d asks about -1 and -3 and nothing else, and a mask with no custom tokens is never asked at all. Detection is token-aware, so the escaped ??1 is a literal ?1 and prompts for nothing. A slot left blank is still skipped, with a warning that hashcat will reject a mask whose charset is undefined
• Mask files (.hcmask) can be selected with tab completion, defaulting to the bundled masks/ directory; hashcat runs every mask in the file in order. Because a mask file defines its own charsets inline, the -1 through -4 prompts are skipped when one is chosen
• Optionally runs the mask incrementally (--increment), trying shorter lengths before the full mask. Answering yes prompts for an increment minimum and maximum; either can be left blank, and leaving both blank increments over the mask's full keyspace with hashcat choosing the bounds. Offered for typed masks and mask files alike
• Useful for targeted brute forcing when you know password structure patterns

Markov Brute Force Attack

Generates password candidates using Markov chain statistical models. Similar to OMEN but simpler and faster.

• Checks for existing .hcstat2 Markov table from previous sessions (with option to reuse, regenerate, or cancel)
• Generates table from training source if needed:
  • Can use cracked passwords from current session (.out file) as training data
  • Or select any wordlist from configured directory or custom path
• Interactive menu: choose minimum and maximum password length
• Uses --increment flag to test lengths in sequence
• Markov table persists with hash file (filename.out.hcstat2) for fast subsequent runs
• Faster than OMEN for general-purpose brute forcing

N-gram Attack

Generates n-gram candidates from a corpus file using ngramX.bin from hashcat-utils and pipes them into hashcat.

• Prompts for a corpus file with tab completion, defaulting to the configured wordlist directory
• Prompts for an n-gram group size (default 3)
• Gzip-compressed corpus files are auto-detected and decompressed on the fly
• Useful when you have target-relevant prose (scraped site copy, leaked documents, internal wiki exports) rather than a password list

Permutation Attack

Generates all character permutations of each word in a targeted wordlist and pipes them to hashcat via permute.bin from hashcat-utils.

• Prompts for a single wordlist file (not a directory)
• Effective against short targeted wordlists where the character set is known but the order is not (company abbreviations, name fragments, known tokens)
• WARNING: Scales as N! per word - an 8-character word produces 40,320 permutations. Only practical for words up to ~8 characters.
• Uses permute.bin < wordlist | hashcat pipeline pattern

Random Rules Attack

Generates a set of random hashcat mutation rules using generate-rules.bin, writes them to a temporary file, then runs hashcat against a chosen wordlist with those rules.

• Prompts for rule count (default 65536)
• Prompts for wordlist path with tab-completion and numbered selection
• Temporary rules file is cleaned up after the run regardless of outcome
• Useful when known rule sets are exhausted - explores random rule-space for additional cracks

Combipow Passphrase Attack

Generates all unique non-empty subset combinations from a short wordlist using combipow.bin and pipes them into hashcat. Designed for passphrase cracking when you know the pool of words a password was built from.

• Prompts for a wordlist file (max 63 lines - combipow generates up to 2^n-1 combinations)
• Optional space separator (-s flag) to insert spaces between words in each combination
• Warns if the wordlist exceeds 20 lines (output volume may be large)
• Aborts with a clear message if the wordlist exceeds 63 lines (hard limit)
• Candidates are piped directly to hashcat stdin

PCFG Attack

Uses pcfg_cracker to generate candidates from a Probabilistic Context-Free Grammar, piping pcfg_guesser.py output directly into hashcat's stdin mode. A PCFG models password structure (baseword + digits + symbol, capitalization habits, keyboard walks) with learned probabilities, so candidates come out roughly in descending likelihood order.

• Requires the pcfg_cracker submodule. Presence is checked at startup and reported non-fatally: if it is missing, the PCFG attacks are simply unavailable. Run make to fetch it.
• Uses the trained grammar named by pcfgRuleset in config.json (default DEFAULT), read from pcfg_cracker/Rules/<name>/
• Candidate count is capped by pcfgMaxCandidates (default 50,000,000)
• hate_crack does not wrap grammar training. To build a grammar from a target-specific password set, run pcfg_cracker's own trainer.py and point pcfgRuleset at the resulting ruleset name

PRINCE-LING Attack

Uses pcfg_cracker's prince_ling.py to derive an optimized PRINCE base wordlist from a trained grammar, then hands it to the existing PRINCE attack. PRINCE-LING picks base words the grammar says are actually productive, so the PRINCE combination space is far less wasteful than pointing PRINCE at a generic wordlist.

• Requires the pcfg_cracker submodule and a trained ruleset directory, same as the PCFG attack
• The generated wordlist is cached at <hcatOptimizedWordlists>/pcfg_prince_ling_<ruleset>.txt and reused across sessions
• Regenerates only when the ruleset directory is newer than the cached wordlist, so retraining a grammar invalidates the cache automatically
• Generation is written to a temporary file and atomically moved into place; a failed or interrupted run cleans up its partial file and leaves any existing cache intact
• Base wordlist size is capped by pcfgPrinceLingMaxCandidates (default 10,000,000)

Spoonman Attack

Derives a baseword list and a hashcat rule file from a corpus of known plaintext passwords — a previous engagement's cracked output, a leak dump, or any password list — such that the baseword x rule cross product reconstructs the corpus exactly (see the memory bound below for the one case where it does not). Contributed as issue #169 by @Spoonman1091.

Each password is split into its letters-only lowercased core (the baseword) plus a rule that rebuilds the original from it, using l/u/c for casing, T{p} toggles, ${x}/^{x} for trailing and leading characters, and i{p}{x} for interior ones.

• When the current session already has cracked plaintexts (<hash file>.out exists and is non-empty), a picker offers those as the corpus ahead of a free-form path — the target's own recovered passwords derive rules describing that target's actual conventions, which is exactly what you want to fire back at the remaining uncracked hashes. Deriving from .out and then cracking the same hash file appends new plaintexts to that same file, growing the corpus for the next run; that is the intended feedback loop, not corruption. Sessions with no cracked output yet see no picker at all — just today's path prompt
• Prompts for the corpus, then for how much of the rule file to run: top 50% coverage (listed first and recommended), top 75%, top 95%, top 99%, or the full set
• Rules are sorted by how many passwords each one rebuilds, so a truncated file keeps the most productive rules. Coverage is extremely long-tailed: on a 98.2M-password sample, 50% coverage needed 4,120 rules while 95% needed 16,119,661 and 100% needed 21,029,696 — the last few percent typically costs orders of magnitude more rules than the first half, which is why the smallest tier is listed first and is usually the right choice
• Output is written beside the hash file in <hash file>.spoonman/, alongside the other ephemeral wordlists: basewords.txt, rules.full.rule, the capped rule files, and coverage.txt with per-milestone rule counts. Derivation is skipped on later runs of the same hash file unless the corpus has been modified since, and the directory is removed on exit by the temp-file cleanup
• Derivation is bounded in memory. Both counters would otherwise grow for the whole read with nothing written until the end, so a corpus large enough to exhaust RAM lost the entire pass to an OOM kill and produced no output; a measured run against a 31 GB corpus reached 14.1 GB resident at 11% of the file and was still accelerating. Each counter is now capped at 20 million distinct keys (about 1.6 GB apiece), and the lowest-frequency keys are discarded once it is exceeded. If that happens, the run says so on the console and in coverage.txt, the output reconstructs the retained keys rather than 100% of the corpus, and the coverage percentages are relative to those. Corpora below the cap are unaffected
• Passwords that cannot be expressed as a rule are written verbatim as their own baseword with a : no-op, so coverage stays complete. This covers two hashcat limits: rule positions cannot address past index 35, and hashcat rejects any rule with more than 31 functions — silently, when valid rules share the file
• A password carrying a literal CR or LF (which arrives hex-wrapped, as $HEX[...0a]) cannot go in a baseword at all, because a wordlist line has no escape syntax for one. The break is lifted out into an insert op instead, spelled \x0a/\x0d in the rule, which hashcat decodes to the byte. When the break sits past addressable index 35 the rule reverses the word first, inserts from the other end, and reverses back. One frame has to hold every break in the password, so what is still skipped is a password with one break outside the first 36 characters and another outside the last 36, or one needing more inserts than the 31-function cap leaves room for. Those are counted as unwritable basewords in coverage.txt and reported, never dropped silently
• The derivation self-checks every password by reconstructing it in-process, and reports any failures rather than reporting success
• Corpus lines may carry a hash in front of the password, as cracked output does. A leading field is dropped only when it has the shape of a hash (a hex digest at a known length, or a crypt-style $id$ string), so hash:salt:plain is handled while a plaintext or wordlist entry containing a colon survives intact. $HEX[...] plaintexts are decoded. If most lines look like an uncracked dump rather than cracked output, coverage.txt records the count and the attack warns — the derived basewords and rules would otherwise be meaningless without any error being raised

Rosetta Attack

Mines hashcat --debug-mode 5 logs for the basewords and rules that already cracked something, then runs their full cross product. Powered by HashcatRosetta, the same library behind Analyze Hashcat Rules.

No setup is needed to feed it: _add_debug_mode_for_rules appends --debug-mode 5 --debug-file to every rule-based hashcat invocation hate_crack makes, so the logs accumulate in hcatDebugLogPath (~/.hate_crack/hashcat_debug by default, one file per session) as a side effect of normal use. A mode 5 log records only candidates that cracked a hash, in the form baseword:rule:candidate:wordlist, which is what makes both halves known-productive against this target population; the trailing wordlist field also shows which list is earning its keep on a multi-wordlist run. HashcatRosetta parses mode 4 and mode 5 alike, so logs written before the switch are still read.

The value is in the cross product rather than the recorded pairs. A pair present in a log has already cracked its hash and will not crack another, but a rule that worked on one baseword has usually never been tried against the others — so N basewords and M rules yield close to N x M untried candidates.

The menu first asks how to rank rules — choices 1-3 below, plus a fourth, unrelated mode:

• Rules can be ranked by application frequency, by how many distinct basewords each one worked on, or by how many unique candidates each one generated. Frequency is the default; baseword spread is the better choice when the goal is a rule set that generalizes past the specific words it was learned from
• Only after one of those three is picked does hate_crack list the logs found in hcatDebugLogPath newest-first with their sizes; pick one, pick all of them (up to 20), or type a path to a log from elsewhere
• Prompts for how many top rules to keep and how many top basewords. Both default to all — a blank answer keeps every winning rule the logs contain, and zero means the same thing. Enter a number to cap either. The keyspace is the product of the two and is printed before hashcat starts
• Output is written beside the hash file in <hash file>.rosetta/ as basewords.txt and rules.rule, alongside the other ephemeral wordlists, and the directory is removed on exit by the temp-file cleanup
• Reading stops at 1,000,000 debug lines, since the analyzer needs the whole batch in memory at once. Truncation is reported on the console rather than assumed harmless — logs from a long run routinely exceed this, in which case the newest log is the one worth selecting
• LLM Mask Attack (4) - a different mode entirely, and the only one that needs no debug logs. Prompts for a natural-language description of the passwords you expect (length, character patterns, symbols, etc.), sends it to the locally configured Ollama model, writes the returned masks to <hash file>.hcmask, and runs a -a 3 hashcat mask attack against them

Corporate Masks Brute Force

Statistical masks (8-14 characters) derived from analysis of 3.2M NTLM hashes cracked on real engagements. Powered by Corporate_Masks, these masks encode realistic password patterns from successful penetration tests.

• Prompts for minimum and maximum mask length (default 8-10)
• Longer lengths cost exponentially more keyspace—start with 8-10 for speed, or 8-12 for thoroughness
• Each mask file is run as a separate hashcat invocation in ascending length order
• Gracefully handles missing mask files (skips them) and absent submodule (prints warning and returns)
• Supports optimized kernels (-O flag) for faster cracking
• Ctrl-C during one length aborts remaining lengths

Wordlist Tools (option 80)

A submenu of wordlist preprocessing utilities using hashcat-utils binaries. All tools read from and write to files on disk. All file and directory path prompts support tab completion.

All binaries are in hate_crack/hashcat-utils/bin/.

Rule File Tools (option 81)

Preprocesses hashcat rule files using cleanup-rules.bin and rules_optimize.bin from hashcat-utils, and downloads rule files from Hashmob.net.

• Clean (1) - removes invalid syntax and duplicate rules using cleanup-rules.bin. Useful after combining rule files or downloading rules from external sources.
• Optimize (2) - consolidates redundant operations using rules_optimize.bin. Reduces rule file size and improves cracking speed.
• Clean and optimize (3) - runs both operations in sequence via a temporary file, then writes the final result.
• Download rules from Hashmob.net (4) - fetches rule files into the configured rulesDirectory.
• Analyze Hashcat rules (5) - opcode frequency analysis of a rule file, powered by HashcatRosetta.

The three preprocessing operations read from an input file and write to a separate output file (original is never modified).

Download Rules from Hashmob.net (Rule File Tools option 4)

Downloads the latest rule files from Hashmob.net's rule repository. These rules are curated and optimized for password cracking and can be used with the Quick Crack and Loopback Attack modes.

• Downloads rule sets in parallel using a thread pool (up to 4 concurrent downloads)
• Skips rules already downloaded locally
• Reports download summary with success/failure counts
• Stores rules in the configured rules directory

Analyze Hashcat Rules (Rule File Tools option 5)

Powered by HashcatRosetta (https://github.com/bandrel/HashcatRosetta), this feature analyzes hashcat rule files to provide detailed insights into rule composition and complexity.

• Prompts for a rule file path
• Displays frequency analysis of rule opcodes (operations)
• Helps understand what transformations a rule set performs
• Useful for rule debugging and optimization

Mask Tools (option 83)

Downloads mask files from Hashmob.net. This is a minimal submenu today — masks have no local file-tooling counterpart to the rule/wordlist cleanup and optimization utilities, only a download capability.

• Download masks from Hashmob.net (1) - fetches mask files into the hate_crack masks directory.

Download Masks from Hashmob.net (Mask Tools option 1)

Downloads mask files from Hashmob.net's mask repository into the hate_crack masks directory for use with mask-based attacks.

• Downloads mask sets in parallel using a thread pool (up to 4 concurrent downloads)
• Skips masks already downloaded locally
• Reports download summary with success/failure counts
• Stores masks in the configured masks directory used by the Ad-hoc Mask Attack
• Supports interactive listing, range selection, and browsing of available mask files

Download Wordlists from Hashmob.net (Wordlist Tools option 9)

Downloads wordlists from Hashmob.net's collection of cracked passwords and commonly used wordlists.

• Interactive menu for browsing available wordlists
• Progress tracking for large downloads
• Stores wordlists in configured wordlist directory

Weakpass Wordlist Menu (Wordlist Tools option 10)

Interactive menu for downloading and managing wordlists from Weakpass.com via BitTorrent.

• Browse available Weakpass wordlist torrents
• Download specific wordlists or entire collections
• Automatic extraction of compressed archives
• Progress tracking for torrent downloads

Hashmob Downloads (Wordlist Tools option 11)

Access a submenu for downloading large-scale password corpora and specialized wordlists from Hashmob.net.

Archives - Downloads yearly full-found password corpora (multi-GB archives containing all cracked passwords from a given year)

• Requires confirmation before downloading -- these archives are large (the listing may show "(unknown size)" since Hashmob's API doesn't currently report a file size per archive)
• Lists all available archives across every year as one globally-numbered list to browse and pick from by index, rather than a per-year picker
• Accepts a (or all) at the selection prompt to download every listed archive, one at a time. A single confirmation naming the archive count and the summed size covers the whole batch; an archive already on disk at its listed size is skipped, one whose size does not match is re-downloaded, and a failure is counted rather than aborting the rest
• Stores archives in the configured wordlist directory for extraction and use

Combined Left Lists - Downloads per-hashcat-mode combined lists of uncracked ("left") hashes from Hashmob.net

• Each list is a set of hashes, not plaintexts, still awaiting a crack for that hashcat mode
• Useful for spotting overlap between your own hash list and hashes the community hasn't cracked yet
• Supports mode selection from the listed hash counts per algorithm

Version History

The full, per-release changelog now lives in CHANGELOG.md.