# dtrail/phonesploit-pro-nethunter architecture

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

- Interactive diagram: https://gitdiagram.com/dtrail/phonesploit-pro-nethunter
- Repository: https://github.com/dtrail/phonesploit-pro-nethunter

## Overview

##### Project type and purpose
- PhoneSploit Pro is a Python-based, command-line penetration-testing toolkit. It orchestrates multiple external tools (ADB, Metasploit, scrcpy, nmap) to automate payload creation, delivery, and meterpreter session acquisition on Android devices.

##### File structure
- Top level:
- phonesploitpro.py – the main CLI controller.
- docs/ – screenshots and documentation.
- requirements.txt – Python dependencies.
- config files (.gitignore, README.md, etc.).
- There is no separate ‘frontend’/‘backend’ folder; the entire application is a single‐process CLI that invokes external services.

##### Key architecture elements from README
- Core features (connect via ADB over USB/Wi-Fi, payload creation via msfvenom, session via msfconsole).
- External dependencies: adb, metasploit-framework, scrcpy, nmap.
- Target: Android device over TCP 5555 (ADB) or USB.

##### Detail
- Both the shell I/O boundary and the system calls boundary.
- Internal module separation (UI vs. release vs. core logic).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User and Interface Layer
    User["User"]:::external -->|runs command| CLI["CLI Interface\n(shell)"]:::external
    CLI -->|stdin/stdout| PythonApp["Python Application"]:::python

    %% Python Application and Modules
    subgraph "Python App Components"
        direction TB
        Core["Core Controller\n(phonesploitpro.py)"]:::python
        Banner["UI Banner Module\n(modules/banner.py)"]:::python
        Color["Colored Output Module\n(modules/color.py)"]:::python
        Release["Update/Release Check Module\n(modules/release.py)"]:::python
    end
    PythonApp -->|calls| Core
    PythonApp -->|calls| Banner
    PythonApp -->|calls| Color
    PythonApp -->|calls| Release

    %% Config & Documentation
    subgraph "Project Files"
        direction TB
        Req["requirements.txt"]:::config
        Readme["README.md"]:::config
        Gitignore[".gitignore"]:::config
        License["LICENSE"]:::config
        Contrib["CONTRIBUTING.md"]:::config
        ConfigYml["_config.yml"]:::config
        Docs["Documentation\n(docs/)"]:::config
        GitHubIssues[".github/ISSUE_TEMPLATE/"]:::config
        GitHubFunding[".github/FUNDING.yml"]:::config
    end

    %% External Tools Layer
    subgraph "External Tools"
        direction TB
        ADBClient["ADB Client"]:::ext
        ADBServer["ADB Server"]:::ext
        MSFVenom["Metasploit\nmsfvenom"]:::ext
        MSFConsole["Metasploit\nmsfconsole"]:::ext
        Scrcpy["scrcpy"]:::ext
        Nmap["nmap"]:::ext
    end
    Core -->|invoke| ADBClient
    Core -->|invoke| MSFVenom
    Core -->|invoke| MSFConsole
    Core -->|invoke| Scrcpy
    Core -->|invoke| Nmap

    %% OS & Runtime
    OS["OS & Python Runtime"]:::os
    ADBClient -->|system call| OS
    ADBServer -->|system call| OS
    MSFVenom -->|system call| OS
    MSFConsole -->|system call| OS
    Scrcpy -->|system call| OS
    Nmap -->|system call| OS

    %% Network and Device
    Network["Network\n(TCP 5555)"]:::cloud
    Device["Android Device"]:::device

    ADBServer <-->|over Wi-Fi/USB| Network
    Network -->|connect| Device
    MSFConsole <-->|Meterpreter session| Network

    %% Classes
    classDef python fill:#D6EAF8,stroke:#1B4F72,font-weight:bold
    classDef ext fill:#D5F5E3,stroke:#145A32,font-weight:bold
    classDef cloud fill:#F9E79F,stroke:#B7950B,font-weight:bold
    classDef device fill:#F5CBA7,stroke:#943126,font-weight:bold
    classDef pythonApp fill:#AED6F1,stroke:#1B4F72,font-weight:bold
    classDef os fill:#E8DAEF,stroke:#6C3483,font-weight:bold
    classDef config fill:#FDEBD0,stroke:#B9770E,font-weight:bold
    classDef external fill:#D6DBDF,stroke:#424949,font-weight:bold

    class PythonApp pythonApp

    %% Click Events
    click Core "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/phonesploitpro.py"
    click Banner "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/modules/banner.py"
    click Color "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/modules/color.py"
    click Release "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/modules/release.py"
    click Docs "https://github.com/dtrail/phonesploit-pro-nethunter/tree/main/docs/"
    click Req "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/requirements.txt"
    click Readme "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/README.md"
    click Gitignore "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/.gitignore"
    click License "https://github.com/dtrail/phonesploit-pro-nethunter/tree/main/LICENSE"
    click Contrib "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/CONTRIBUTING.md"
    click ConfigYml "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/_config.yml"
    click GitHubIssues "https://github.com/dtrail/phonesploit-pro-nethunter/tree/main/.github/ISSUE_TEMPLATE/"
    click GitHubFunding "https://github.com/dtrail/phonesploit-pro-nethunter/blob/main/.github/FUNDING.yml"
```
