# blank-c/blank-grabber architecture

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

- Interactive diagram: https://gitdiagram.com/blank-c/blank-grabber
- Repository: https://github.com/blank-c/blank-grabber

## Overview

##### Main Components

a) Builder Component:
- GUI Builder (gui.py) as the entry point
- Configuration flow from user input to stub generation
- Components directory interaction

b) Stub Generation Pipeline:
- Build process flow
- Obfuscation process (BlankOBF.py)
- Post-processing steps (postprocess.py)

c) Payload/Stub Execution Flow:
- Main stub functionality (stub.py)
- Loader mechanism (loader.py)
- Process handling (process.py)

##### Builder Layer
**┌─────────────────────────────────────┐**
- GUI Builder              │
- (Configuration & Build Management)  │
- ┘

##### Generation Layer
**┌─────────────┐  ┌──────────────┐  ┌────────────────┐**
- Obfuscation │→ │ Compilation  │→ │ Post-Processing│
- ┘  └──────────────┘  └────────────────┘

##### Execution Layer
**┌──────────┐  ┌───────────────┐  ┌─────────────┐**
- Loader  │→ │ Main Payload  │→ │ Data Export │
- ┘  └───────────────┘  └─────────────┘

- Use RED for security-critical components
- Use BLUE for build/generation components
- Use GREEN for data collection components
- Use YELLOW for utility components

Important Elements to Include:

- → for direct flow
- ⇢ for conditional flow
- ⇄ for bidirectional communication

##### Component Interactions
- How Components/ directory items interact
- External service connections (Discord/Telegram)
- System interaction points (Anti-VM, UAC Bypass)

##### Security Features
- Anti-VM mechanisms
- UAC bypass flow
- AV site blocking mechanism

##### Data Collection Points
- Browser data extraction
- System information gathering
- Token/session stealing
- Screenshot/webcam capture

##### Exfiltration Routes
- Discord webhook
- Telegram bot
- Data packaging and encryption

Special Considerations:

##### A separate "Protection Mechanisms" section showing
- Anti-VM components
- UAC bypass
- AV site blocking
- Persistence mechanisms

##### A "Configuration" section displaying
- Stub settings
- Build options
- Runtime configurations

- Target applications
- Data types
- Collection methods

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and Classes
    classDef builder fill:#2196F3,stroke:#1565C0,color:white
    classDef security fill:#F44336,stroke:#B71C1C,color:white
    classDef execution fill:#4CAF50,stroke:#1B5E20,color:white
    classDef utility fill:#FFC107,stroke:#FF8F00,color:black
    classDef config fill:#9C27B0,stroke:#4A148C,color:white
    
    %% Builder Layer
    subgraph BuilderLayer
        GUI["GUI Builder"]:::builder
        BuildProc["Build Process"]:::builder
        Config["Configuration Management"]:::config
    end
    
    %% Generation Layer
    subgraph GenerationLayer
        Obfuscator["Obfuscation Component"]:::builder
        PostProc["Post Processing"]:::builder
        BinSign["Binary Signing"]:::builder
    end
    
    %% Execution Layer
    subgraph ExecutionLayer
        Loader["Loader Mechanism"]:::execution
        Stub["Main Stub"]:::execution
        Process["Process Handler"]:::execution
    end
    
    %% Protection Layer
    subgraph ProtectionLayer
        AntiVM["Anti-VM"]:::security
        UACBypass["UAC Bypass"]:::security
        SiteUnblock["Site Unblocking"]:::security
    end
    
    %% Data Collection Layer
    subgraph DataLayer
        Browser["Browser Data"]:::execution
        System["System Info"]:::execution
        Tokens["Token Stealer"]:::execution
        Media["Media Capture"]:::execution
    end
    
    %% Connections
    GUI --> BuildProc
    GUI --> Config
    BuildProc --> Obfuscator
    Obfuscator --> PostProc
    PostProc --> BinSign
    BinSign --> Loader
    Loader --> Stub
    Stub --> Process
    Process --> ProtectionLayer
    Process --> DataLayer
    
    %% Data Exfiltration
    DataLayer --> Discord["Discord Webhook"]:::utility
    DataLayer --> Telegram["Telegram Bot"]:::utility
    
    %% Click Events
    click GUI "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/gui.py"
    click BuildProc "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Builder.bat"
    click Obfuscator "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Components/BlankOBF.py"
    click PostProc "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Components/postprocess.py"
    click Stub "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Components/stub.py"
    click Loader "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Components/loader.py"
    click Process "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Components/process.py"
    click Config "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Components/config.json"
    click SiteUnblock "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Extras/unblock_sites.py"
    click BinSign "https://github.com/Blank-c/Blank-Grabber/blob/main/Blank Grabber/Components/sigthief.py"
    
    %% Legend
    subgraph Legend
        Builder["Builder Component"]:::builder
        SecComp["Security Component"]:::security
        ExecComp["Execution Component"]:::execution
        UtilComp["Utility Component"]:::utility
        ConfigComp["Configuration Component"]:::config
    end
```
