# flickgmd/bashbreaker architecture

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

- Interactive diagram: https://gitdiagram.com/flickgmd/bashbreaker
- Repository: https://github.com/flickgmd/bashbreaker

## Overview

##### Main Components
- User Interface (CLI): Represents how the user interacts with the tool via terminal commands.
- MD5 Cracking Module (md5Crack.sh): Handles the process of taking a provided MD5 hash and a wordlist to attempt a dictionary attack.
- ZIP Password Cracking Module (DestroyZip.sh): Manages attacking ZIP files using brute force with a wordlist.
- External Dependencies: Include system-level dependencies (like the “unzip” package) that are required for the ZIP cracking function.

##### Architectural Patterns and Design Principles
- That it’s a modular, script-based architecture where each script has a single responsibility.
- Stress the separation of concerns even in a simple Bash project by isolating the external dependency (unzip) from the internal logic.

##### Integrate Relevant Technologies and Tools
- That the project expects a proper wordlist file (e.g., rockyou.txt) for dictionary attacks, which should also be represented as an external input.
- Optionally, denote the command parameters (flags such as -c, -z, -w, -x, and -h) as inputs that modulate the behavior of the modules.

## Diagram (Mermaid)

```mermaid
flowchart TD
    A("User CLI"):::input
    B("Wordlist File (rockyou.txt)"):::input

    subgraph "Cracking Modules"
        C("MD5 Cracking Module"):::main
        D("ZIP Password Cracking Module"):::main
    end

    E("Colors Library"):::dependency
    F("External unzip Dependency"):::external

    A -->|"invokes"| C
    A -->|"invokes"| D
    B -->|"provides"| C
    B -->|"provides"| D
    C -.->|"sources"| E
    D -.->|"sources"| E
    D -->|"calls"| F

    click C "https://github.com/flickgmd/bashbreaker/blob/main/md5Crack.sh"
    click D "https://github.com/flickgmd/bashbreaker/blob/main/DestroyZip.sh"
    click E "https://github.com/flickgmd/bashbreaker/blob/main/Colors.sh"

    classDef input fill:#b3e5fc,stroke:#0277bd,stroke-width:2px;
    classDef main fill:#ffecb3,stroke:#ff9800,stroke-width:2px;
    classDef dependency fill:#d1c4e9,stroke:#673ab7,stroke-width:2px;
    classDef external fill:#c8e6c9,stroke:#388e3c,stroke-width:2px;
```
