# chegebb/facebook-brutex architecture

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

- Interactive diagram: https://gitdiagram.com/chegebb/facebook-brutex
- Repository: https://github.com/chegebb/facebook-brutex

## Overview

##### Project Type & Purpose
- This is a single-script educational tool that uses Selenium to automate Facebook login attempts by iterating over wordlists.
- The purpose is to educate users on brute-forcing techniques, web automation, and password security, with a strong disclaimer emphasizing ethical use.

##### Analyzing the File Structure
- The main application is contained in FbBruteX.py.
- Wordlist files (e.g., rockyou.txt, darkWeb.txt, top1000.txt) form a core part of the tool for testing multiple passwords.
- Supporting files include LICENSE, README.md, and requirements.txt which handle permissions, usage instructions, and dependency management.
- The structure is flat, indicating that the logic is likely contained in a single file and uses external text resources to supply data.

##### Key Components
a. User Interface/Input Module:
- Represents the initial interaction where the user selects a platform, a wordlist, and inputs target credentials.
- This can be shown as a terminal/CLI component.

b. Selenium WebDriver Automation Module:
- Core engine of the script that automates web browsing tasks.
- This component handles simulating user input, performing login attempts, and detecting CAPTCHA challenges.

c. Wordlist Management:
- Module or process that reads password guesses from various text files.

d. CAPTCHA Handling:
- A sub-component of the Selenium automation where the script pauses for manual CAPTCHA solving.
- Mention the time-out (30 seconds) and the fallback behavior if unsolved.

e. Logging/Feedback Mechanism:
- How the script provides progress feedback – displaying the current attempt and possibly a spinner animation.

f. Configuration & Dependency Manager:
- Although minimal, include the requirements.txt and any configuration aspect (e.g., Selenium settings) that are used to set up the environment.

##### Relationships & Interactions
- Wordlist management block to the Selenium module (showing that each password attempt is driven by the wordlist).

##### Architectural Patterns & Technologies
- Single-script nature where separation of concerns is handled within the code rather than a multi-tiered structure.
- Use of Selenium WebDriver as the central technology.
- Mention that while the project doesn’t use a formal MVC or microservices pattern, it does distinguish different operational modules (input, processing, feedback) within the codebase.

## Diagram (Mermaid)

```mermaid
graph TD
    UI["User Input / CLI"]:::input
    Selenium["Selenium WebDriver Module"]:::process
    WordlistMan["Wordlist Manager"]:::process
    Captcha["CAPTCHA Handler"]:::decision
    Logger["Feedback Logger"]:::output
    Config["Configuration & Dependency Manager"]:::config

    Wordlist1["rockyou.txt"]:::wordlist
    Wordlist2["darkWeb.txt"]:::wordlist
    Wordlist3["top1000.txt"]:::wordlist
    Wordlist4["PhantomStrike.txt"]:::wordlist
    Wordlist5["StormBreaker.txt"]:::wordlist
    Wordlist6["bestof.txt"]:::wordlist
    Wordlist7["easy_passwords.txt"]:::wordlist

    UI -->|"starts"| Selenium
    Config -->|"configures"| Selenium
    Selenium -->|"drives"| WordlistMan
    Selenium -->|"checks"| Captcha
    Selenium -->|"logs"| Logger
    WordlistMan -->|"reads-from"| Wordlist1
    WordlistMan -->|"reads-from"| Wordlist2
    WordlistMan -->|"reads-from"| Wordlist3
    WordlistMan -->|"reads-from"| Wordlist4
    WordlistMan -->|"reads-from"| Wordlist5
    WordlistMan -->|"reads-from"| Wordlist6
    WordlistMan -->|"reads-from"| Wordlist7
    WordlistMan -->|"iterates"| Selenium

    click UI "https://github.com/chegebb/facebook-brutex/blob/main/FbBruteX.py"
    click Selenium "https://github.com/chegebb/facebook-brutex/blob/main/FbBruteX.py"
    click Captcha "https://github.com/chegebb/facebook-brutex/blob/main/FbBruteX.py"
    click Logger "https://github.com/chegebb/facebook-brutex/blob/main/FbBruteX.py"
    click Config "https://github.com/chegebb/facebook-brutex/blob/main/requirements.txt"
    click Wordlist1 "https://github.com/chegebb/facebook-brutex/blob/main/rockyou.txt"
    click Wordlist2 "https://github.com/chegebb/facebook-brutex/blob/main/darkWeb.txt"
    click Wordlist3 "https://github.com/chegebb/facebook-brutex/blob/main/top1000.txt"
    click Wordlist4 "https://github.com/chegebb/facebook-brutex/blob/main/PhantomStrike.txt"
    click Wordlist5 "https://github.com/chegebb/facebook-brutex/blob/main/StormBreaker.txt"
    click Wordlist6 "https://github.com/chegebb/facebook-brutex/blob/main/bestof.txt"
    click Wordlist7 "https://github.com/chegebb/facebook-brutex/blob/main/easy_passwords.txt"

    classDef input fill:#add8e6,stroke:#333,stroke-width:2px;
    classDef process fill:#90ee90,stroke:#333,stroke-width:2px;
    classDef decision fill:#ffcccb,stroke:#333,stroke-width:2px;
    classDef output fill:#dda0dd,stroke:#333,stroke-width:2px;
    classDef config fill:#ffff99,stroke:#333,stroke-width:2px;
    classDef wordlist fill:#f0e68c,stroke:#333,stroke-width:2px;
```
