# iamblackhacker/facebook-bruteforce architecture

> Architecture diagram of the GitHub repository iamblackhacker/facebook-bruteforce, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iamblackhacker/facebook-bruteforce
- Repository: https://github.com/iamblackhacker/facebook-bruteforce

## Overview

This repository provides two command-line variants of a password-list login tester: `fb.py` for Python 3 and `fb2.py` for Python 2. The workflow takes a target account identifier, reads candidate passwords from `passwords.txt`, and submits login attempts to Facebook; each variant detects selected response text as a success signal and prints the candidate. The Python 3 variant fetches login-form data and refreshes it periodically, while the Python 2 variant uses Mechanize. The README documents both launch choices. Evidence is limited to the README and the two excerpted scripts.

Main entry points: [`fb.py`](https://github.com/iamblackhacker/facebook-bruteforce/blob/master/fb.py) (Python 3 runner), [`fb2.py`](https://github.com/iamblackhacker/facebook-bruteforce/blob/master/fb2.py) (Python 2 runner), [`passwords.txt`](https://github.com/iamblackhacker/facebook-bruteforce/blob/master/passwords.txt) (Password list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runners["Command-line runners"]
  node_python3_runner["Python 3 runner<br/>[fb.py]"]
  node_python2_runner["Python 2 runner<br/>[fb2.py]"]
end

subgraph group_inputs["Inputs and service"]
  node_password_list["Password list<br/>[passwords.txt]"]
  node_facebook_login{{"Facebook login"}}
end

node_operator(("Operator"))

node_operator -->|"launches"| node_python3_runner
node_operator -->|"launches"| node_python2_runner
node_operator -->|"enters account"| node_python3_runner
node_operator -->|"enters account"| node_python2_runner
node_python3_runner -->|"reads"| node_password_list
node_python2_runner -->|"reads"| node_password_list
node_python3_runner -->|"fetches form; submits attempts"| node_facebook_login
node_python2_runner -->|"opens; submits attempts"| node_facebook_login

click node_python3_runner "https://github.com/iamblackhacker/facebook-bruteforce/blob/master/fb.py"
click node_python2_runner "https://github.com/iamblackhacker/facebook-bruteforce/blob/master/fb2.py"
click node_password_list "https://github.com/iamblackhacker/facebook-bruteforce/blob/master/passwords.txt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_python3_runner,node_python2_runner toneBlue
class node_password_list,node_facebook_login toneAmber
class node_operator toneIndigo
```

## Components

### Command-line runners

- [Python 3 runner](https://github.com/iamblackhacker/facebook-bruteforce/blob/master/fb.py): `fb.py`
- [Python 2 runner](https://github.com/iamblackhacker/facebook-bruteforce/blob/master/fb2.py): `fb2.py`

### Inputs and service

- [Password list](https://github.com/iamblackhacker/facebook-bruteforce/blob/master/passwords.txt): `passwords.txt`
- **Facebook login**

### Other components

- **Operator**

## Connections

- Operator → Python 3 runner: launches (evidence: `README.md`)
- Operator → Python 2 runner: launches (evidence: `README.md`)
- Operator → Python 3 runner: enters account (evidence: `fb.py`)
- Operator → Python 2 runner: enters account (evidence: `fb2.py`)
- Python 3 runner → Password list: reads (evidence: `fb.py`)
- Python 2 runner → Password list: reads (evidence: `fb2.py`)
- Python 3 runner → Facebook login: fetches form; submits attempts (evidence: `fb.py`)
- Python 2 runner → Facebook login: opens; submits attempts (evidence: `fb2.py`)
