# nightfallgt/discord-account-generator architecture

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

- Interactive diagram: https://gitdiagram.com/nightfallgt/discord-account-generator
- Repository: https://github.com/nightfallgt/discord-account-generator

## Overview

This repository is a command-line proof of concept for automating Discord account creation. Its principal workflow selects account details and proxy settings, drives a browser through registration and token retrieval, checks email for a verification link, then appends credentials to an output file. It also offers normal and threaded modes. The main runtime stages live in one script; the supporting package provides menu display and Gmailnator API helpers. Some orchestration details are omitted from the excerpts, so those relationships are shown only where documented or marked unverified.

Main entry points: [`discordgenerator.py`](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py) (Worker dispatch), [`src/api.py`](https://github.com/nightfallgt/discord-account-generator/blob/main/src/api.py) (Gmailnator helpers), [`src/ui.py`](https://github.com/nightfallgt/discord-account-generator/blob/main/src/ui.py) (Menu display), [`config/discord_usernames.txt`](https://github.com/nightfallgt/discord-account-generator/blob/main/config/discord_usernames.txt) (Username list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Account workflow"]
  node_cli["CLI and modes"]
  node_dispatch["Worker dispatch"]
  node_identity["Account details"]
  node_proxy["Proxy selection"]
  node_registration["Browser registration"]
  node_verification["Email verification"]
  node_token["Token retrieval"]
  node_credentials["Credential output"]
end

subgraph group_support["Supporting modules"]
  node_ui["Menu display<br/>[ui.py]"]
  node_gmail_api["Gmailnator helpers<br/>[api.py]"]
end

subgraph group_inputs["Local inputs and output"]
  node_usernames["Username list"]
  node_proxies["Proxy list<br/>[proxies.txt]"]
  node_login_file["Login records<br/>[login.txt]"]
end

subgraph group_services["External services"]
  node_discord{{"Discord"}}
  node_gmailnator{{"Gmailnator service"}}
end

node_user(("Operator"))

node_user -->|"starts"| node_cli
node_cli -->|"displays menus"| node_ui
node_cli -->|"selects mode"| node_dispatch
node_dispatch -->|"starts worker"| node_identity
node_dispatch -->|"selects proxy"| node_proxy
node_identity -->|"reads"| node_usernames
node_proxy -->|"reads"| node_proxies
node_dispatch -->|"runs worker"| node_registration
node_registration -->|"registers account"| node_discord
node_registration -->|"extracts token"| node_token
node_token -->|"writes credentials"| node_credentials
node_credentials -->|"appends records"| node_login_file
node_dispatch -->|"coordinates verification"| node_verification
node_verification -.->|"checks inbox"| node_gmail_api
node_gmail_api -->|"requests mailbox"| node_gmailnator
node_verification -->|"opens verify link"| node_discord

click node_cli "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_dispatch "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_identity "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_proxy "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_registration "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_verification "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_token "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_credentials "https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py"
click node_ui "https://github.com/nightfallgt/discord-account-generator/blob/main/src/ui.py"
click node_gmail_api "https://github.com/nightfallgt/discord-account-generator/blob/main/src/api.py"
click node_usernames "https://github.com/nightfallgt/discord-account-generator/blob/main/config/discord_usernames.txt"
click node_proxies "https://github.com/nightfallgt/discord-account-generator/blob/main/config/proxies.txt"
click node_login_file "https://github.com/nightfallgt/discord-account-generator/blob/main/output/login.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_cli,node_dispatch,node_identity,node_proxy,node_registration,node_verification,node_token,node_credentials toneBlue
class node_ui,node_gmail_api toneAmber
class node_usernames,node_proxies,node_login_file toneMint
class node_discord,node_gmailnator toneRose
class node_user toneIndigo
```

## Components

### Account workflow

- [CLI and modes](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`
- [Worker dispatch](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`
- [Account details](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`
- [Proxy selection](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`
- [Browser registration](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`
- [Email verification](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`
- [Token retrieval](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`
- [Credential output](https://github.com/nightfallgt/discord-account-generator/blob/main/discordgenerator.py): `discordgenerator.py`

### Supporting modules

- [Menu display](https://github.com/nightfallgt/discord-account-generator/blob/main/src/ui.py): `src/ui.py`
- [Gmailnator helpers](https://github.com/nightfallgt/discord-account-generator/blob/main/src/api.py): `src/api.py`

### Local inputs and output

- [Username list](https://github.com/nightfallgt/discord-account-generator/blob/main/config/discord_usernames.txt): `config/discord_usernames.txt`
- [Proxy list](https://github.com/nightfallgt/discord-account-generator/blob/main/config/proxies.txt): `config/proxies.txt`
- [Login records](https://github.com/nightfallgt/discord-account-generator/blob/main/output/login.txt): `output/login.txt`

### External services

- **Discord**
- **Gmailnator service**

### Other components

- **Operator**

## Connections

- Operator → CLI and modes: starts (evidence: `README.md`)
- CLI and modes → Menu display: displays menus (evidence: `discordgenerator.py`)
- CLI and modes → Worker dispatch: selects mode (evidence: `discordgenerator.py`)
- Worker dispatch → Account details: starts worker (evidence: `discordgenerator.py`)
- Worker dispatch → Proxy selection: selects proxy (evidence: `discordgenerator.py`)
- Account details → Username list: reads (evidence: `discordgenerator.py`)
- Proxy selection → Proxy list: reads (evidence: `discordgenerator.py`)
- Worker dispatch → Browser registration: runs worker (evidence: `discordgenerator.py`)
- Browser registration → Discord: registers account (evidence: `discordgenerator.py`)
- Browser registration → Token retrieval: extracts token (evidence: `discordgenerator.py`)
- Token retrieval → Credential output: writes credentials (evidence: `discordgenerator.py`)
- Credential output → Login records: appends records (evidence: `discordgenerator.py`)
- Worker dispatch → Email verification: coordinates verification (evidence: `discordgenerator.py`)
- Email verification → Gmailnator helpers: checks inbox
- Gmailnator helpers → Gmailnator service: requests mailbox (evidence: `src/api.py`)
- Email verification → Discord: opens verify link (evidence: `discordgenerator.py`)