# edarmy/hacking-tools architecture

> Architecture diagram of the GitHub repository edarmy/hacking-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edarmy/hacking-tools
- Repository: https://github.com/edarmy/hacking-tools

## Overview

##### Main Components
- Tools by category, as they’re organized by directories. For instance:
- Network & Scanning Tools: Banner Grabbing, Port Scanning, Reverse Shell, DNS Enumeration.
- Vulnerability & Information Gathering: CVE Search, Domain Information, Subdomain Discovery.
- Forensics & Analysis Tools: Forensic Investigations (with submodules for Metadata Extraction on PDFs/images, Log File Analysis, Cookie Grabbing, Password Grab, and even hidden message extraction).
- Other Utility Modules: Keylogger, Ransomware (basic), and Q-Coding.
- Using a central “Hacking Tools Repository” node (or hub), even if every component works largely independently.

##### Relationships and Interactions
- Shared dependencies: Some directories include requirements.txt files (e.g., image and PDF metadata extraction tools, geo locating IP modules), indicating external libraries being loaded.
- Potential data flows: For example, a user might use a network scanning tool to identify live hosts and then use vulnerability assessment or forensics tools on the targets.
- Modular independence: Although the tools are grouped by their functions, they could be loosely coupled. Show that they are part of the same toolkit but share a common interface (usually via the command line).

##### Architectural Patterns or Design Principles
- Modular design. Each tool is designed for a specific task (e.g., banner grabbing or cookie grabbing), suggesting a functional decomposition.
- That many of these are command-line utilities that might be chained together manually by a security professional.
- “common entry points” such as shared configuration or frequent dependency installations for some submodules.

##### Incorporate Technologies and Frameworks
- Since each component is typically a Python script (and occasionally includes shell scripts or HTML files for output), denote Python as the primary technology.
- For components with requirements.txt, note that third-party libraries are used in certain modules.
- Mention external systems where applicable (for example, if a tool interfaces with a remote system for network scanning or for geolocation lookups).

## Diagram (Mermaid)

```mermaid
flowchart TD
    HTR["Hacking Tools Repository"]:::hub

    subgraph "Network & Scanning Tools"
        BG["Banner Grabbing (bg.py)"]:::network
        PS["Port Scanning (PORTSCANNING.py)"]:::network
        RS["Reverse Shell (cl.py, rs.py)"]:::network
        DNS["DNS Enumeration (dnsenum.py)"]:::network
    end

    subgraph "Vulnerability & Information Gathering"
        CVE["CVE Search (cve.py, lav.py)"]:::vuln
        DI["Domain Information (domain.py)"]:::vuln
        SD["Subdomain Discovery (subdomaindns.py)"]:::vuln
    end

    subgraph "Web and Service Analysis"
        FI["Favicon Icon Hash (favhash.py)"]:::web
        DW["Dark Web Tools (onionlinks.py)"]:::web
    end

    subgraph "Forensics & Analysis Tools"
        PDF["PDF Metadata Extraction (pdf.py)"]:::forensic
        IMG["Image Metadata Extraction (image.py)"]:::forensic
        LOG["Log File Analysis (log_analyser.py)"]:::forensic
        CK["Cookie Grabbing (cc.py, cc2.py)"]:::forensic
        DP["Detect Phishing Attack"]:::forensic
        PG["Password Grab (expfc.py)"]:::forensic
        QC["Q-Coding (qc.py, ec.sh)"]:::forensic
    end

    subgraph "Other Utility Modules"
        KL["Keylogger (keylog.py)"]:::other
        RS2["Ransomware (read directory)"]:::other
        RH["Read Hidden Message (rhm.py)"]:::other
    end

    %% Connections from central repository to each main cluster (representative tool)
    HTR -->|"access"| BG
    HTR -->|"access"| CVE
    HTR -->|"access"| FI
    HTR -->|"access"| PDF
    HTR -->|"access"| KL

    %% Inter-tool interactions and dependency flows
    BG -->|"scans->gathers"| CVE
    PS -->|"scans->discovers"| SD
    DNS -->|"resolves"| DI
    CVE -->|"triggers"| PDF
    SD -->|"feeds data to"| PG
    CK -->|"alerts"| DP
    PG -->|"chains to"| QC

    %% Styles definitions
    classDef hub fill:#FFBF00,stroke:#333,stroke-width:2px;
    classDef network fill:#AED6F1,stroke:#000,stroke-width:1px;
    classDef vuln fill:#A9DFBF,stroke:#000,stroke-width:1px;
    classDef web fill:#F5B7B1,stroke:#000,stroke-width:1px;
    classDef forensic fill:#F9E79F,stroke:#000,stroke-width:1px;
    classDef other fill:#D7BDE2,stroke:#000,stroke-width:1px;

    %% Click events for Network & Scanning Tools
    click BG "https://github.com/edarmy/hacking-tools/blob/main/Banner Grabbing/bg.py"
    click PS "https://github.com/edarmy/hacking-tools/blob/main/PORT SCANNING/PORTSCANNING.py"
    click RS "https://github.com/edarmy/hacking-tools/blob/main/reverse shell/cl.py"
    click DNS "https://github.com/edarmy/hacking-tools/blob/main/dns Enumeration/dnsenum.py"

    %% Click events for Vulnerability & Information Gathering
    click CVE "https://github.com/edarmy/hacking-tools/blob/main/CVE search/cve.py"
    click DI "https://github.com/edarmy/hacking-tools/blob/main/Domain information al in one/domain.py"
    click SD "https://github.com/edarmy/hacking-tools/blob/main/subdomain/subdomaindns.py"

    %% Click events for Web and Service Analysis
    click FI "https://github.com/edarmy/hacking-tools/blob/main/favicon icon hash/favhash.py"
    click DW "https://github.com/edarmy/hacking-tools/blob/main/dark web/onionlinks.py"

    %% Click events for Forensics & Analysis Tools
    click PDF "https://github.com/edarmy/hacking-tools/blob/main/Forensic Investigations/Extracting Metadata/PDF File/pdf.py"
    click IMG "https://github.com/edarmy/hacking-tools/blob/main/Forensic Investigations/Extracting Metadata/image file/image.py"
    click LOG "https://github.com/edarmy/hacking-tools/blob/main/Forensic Investigations/Log file analysis/log_analyser.py"
    click CK "https://github.com/edarmy/hacking-tools/blob/main/Forensic Investigations/coockie grub/cc.py"
    click DP "https://github.com/edarmy/hacking-tools/tree/main/Forensic Investigations/detect phishing attack"
    click PG "https://github.com/edarmy/hacking-tools/blob/main/Forensic Investigations/password grab/expfc.py"
    click QC "https://github.com/edarmy/hacking-tools/blob/main/Forensic Investigations/q-coding/qc.py"

    %% Click events for Other Utility Modules
    click KL "https://github.com/edarmy/hacking-tools/blob/main/keylogger/keylog.py"
    click RS2 "https://github.com/edarmy/hacking-tools/tree/main/ransomeware/read"
    click RH "https://github.com/edarmy/hacking-tools/blob/main/read hidden message/rhm.py"
```
