DorkEye v4.3

[xPloits3c]

DorkEye v4.3.4

HTML Report Engine • Dynamic Category Resolution • Bug Fixes & Stability

DorkEye v4.3.4 is a targeted improvement release focused on three core areas: a significantly richer HTML report interface, a fully dynamic Dork Generator category system, and a collection of stability and bug fixes accumulated since v4.2.6.

---

🔥 What's New in v4.3.4

---

📊 HTML Report Engine — Redesigned Filter & Category System

The HTML report (-o report.html) has been substantially upgraded with a richer, more interactive interface.

Sub-filter Dropdown Menus

Filter buttons now feature hierarchical sub-menus, allowing granular filtering without losing context:

Group	Sub-filters Available
DOC	ALL · PDF · DOCX · XLSX · PPT · ARCHIVES
SQLi	SQLi ALL · SQLi VULN · SQLi SAFE
SCRIPTS	ALL · PHP · ASP · SH/BAT · CONFIGS · CREDS
PAGE	(single level, no sub-menu)

Each main filter button now displays a live badge counter showing the number of results in that group. Sub-menu items show individual counts per format/type, dynamically populated from actual result data.

Active State & Visual Feedback

• Active filter button highlights with full green fill + glow (box-shadow)
• Sub-menu arrows rotate on open (▼ → ▲)
• Active sub-filter info line below the bar shows the current applied filter
• Smooth transitions on hover and activation (0.15s)

Per-result Download Button

Each URL row now includes an inline download button (↓) that triggers a direct file download via the HTML download attribute — useful for quick retrieval of exposed documents, archives, and configs found during research.

Category Color Coding

Result rows are tagged and color-coded by category directly in the table:

Category	Color
documents	Blue (#3498db)
archives	Orange (#e67e22)
backups	Yellow (#f39c12)
databases	Red (#e74c3c)
configs	Teal (#1abc9c)
scripts	Yellow-green (#f1c40f)
credentials	Red (#e74c3c)
webpage	Gray (#7f8c8d)

Matrix Background Canvas

The report now features a Matrix-style animated canvas background (#matrix-canvas) rendered at 32% opacity, providing a consistent OSINT-terminal aesthetic without impacting readability of the content layer above.

SQLi Security Alert Banner

When SQL injection vulnerabilities are detected, the report now renders a pulsing red alert banner at the top of the results section, clearly communicating the count and severity before the table is reached.

---

🧠 Dork Generator — Full Dynamic Category Resolution

Previously, the --dg argument validated user input against a hardcoded internal list:

sqli, backups, admin, sensitive

This meant any custom categories defined in user YAML template files were silently rejected or caused unexpected behavior.

In v4.3.4, category resolution is now fully dynamic:

def get_categories_from_templates(template_files) -> List[str]:
    """Reads available categories directly from YAML template files"""
    categories = set()
    for template_file in template_files:
        with open(template_file, "r", encoding="utf-8") as f:
            data = yaml.safe_load(f)
            if data and "templates" in data:
                categories.update(data["templates"].keys())
    return sorted(categories)

What this means in practice:

• VALID_CATEGORIES is now built at runtime by reading all loaded template files
• --dg=<category> validates against the actual keys present in your YAML, not a fixed list
• --dg=all expands to all categories found across all loaded templates
• Error messages now display the real available categories from your templates
• Custom template files with any category names are fully supported without code changes

Before v4.3.4:

$ dorkeye --dg=recon --mode=soft
error: Invalid category 'recon'. Available: sqli, backups, admin, sensitive

After v4.3:

$ dorkeye --dg=recon --mode=soft
[*] Generated 142 dorks (mode: soft)
[*] Categories: recon

---

⚙️ Bug Fixes & Stability

• Fixed category validation rejecting legitimate user-defined YAML template categories
• Fixed --dg=all not expanding to custom categories defined outside the legacy hardcoded list
• Corrected badge counter display in HTML report for doc group (archives were not being counted correctly)
• Fixed sub-filter JavaScript not resetting badge highlights when switching between main filter groups
• Corrected sqli_safe count computation in _save_html() — previously counted all non-vulnerable results rather than only tested ones
• Fixed template loading edge case where get_categories_from_templates() could silently skip malformed YAML files without warning
• Stabilized CLI flag combination: --dg + --templates= + --mode now resolves in correct priority order without conflicts
• Minor: corrected KeyboardInterrupt handler — was printing [/yellow] close tag on a [red] formatted string

---

🖥 CLI — Updated Help & Examples

The --epilog help block has been updated to reflect the new dynamic category system. Examples now demonstrate custom template usage more clearly:

# Use a custom template with user-defined categories
dorkeye --dg=recon --templates=dorks_templates_research.yaml --mode=medium

# Run all categories across all templates
dorkeye --dg=all --templates=all --mode=soft -o results.html

# SQLi scan with aggressive generation + stealth
dorkeye --dg=sqli --mode=aggressive --sqli --stealth -o report.html

---

📦 Template System — Compatibility

v4.3.4 is fully backwards compatible with existing YAML templates from v4.2.x.

Both template structures (nested soft/medium/aggressive dict and flat list with mode: key) continue to be supported by DorkGenerator.

---

🧭 Roadmap (v4.4+)

• --templates=list — auto-list available templates and their categories
• Template validation schema (pre-run YAML integrity check)
• Advanced HTML report: column sorting, search bar, export to CSV from browser
• Optional profile presets (e.g. --profile=recon, --profile=hardening)
• Further false positive reduction in SQLi engine
• Expanded default DG datasets

---

🟢 Summary

Area	Change
HTML Report	Sub-filter dropdowns, badge counters, download buttons, Matrix canvas, SQLi alert banner, category color coding
Dork Generator	Dynamic category resolution from YAML — no more hardcoded category list
Bug Fixes	8 targeted fixes across report generation, CLI validation, and template loading
Backwards Compatibility	Full — existing templates and CLI commands unchanged

---

Less hardcoding. More extensibility.
Dynamic OSINT. Controlled Intelligence.

---

DorkEye v4.3.4 | xploits3c.github.io/DorkEye
Legal disclaimer: attacking targets without prior mutual consent is illegal. It is the end user's responsibility to obey all applicable local, state and federal laws.

---

This discussion was created from the release DorkEye v4.3.