# coili/obfuscadaptix architecture

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

- Interactive diagram: https://gitdiagram.com/coili/obfuscadaptix
- Repository: https://github.com/coili/obfuscadaptix

## Overview

##### Project type and purpose
- This is a small, open-source, command-line obfuscation tool (written in Python) that processes a given Windows .exe beacon, applies transformation/obfuscation techniques, and writes out an obfuscated executable plus its DLL.

##### File structure
- Top level:
- README.md – project overview and usage
- obfuscadaptix.py – the main Python script and entry point
- dependencies/ – any bundled or third-party modules (e.g., custom obfuscation routines, parsers, binary manipulation helpers)
- No frontend/backend split, no external services—pure CLI application.
- Key patterns: a simple modular CLI pipeline (argument parsing → binary loading → obfuscation passes → file output).

##### README for additional insights
- Dependencies: requires Python and the “rich” library at minimum.
- Usage: invoked as “python3 obfuscadaptix.py -f /path/to/beacon” and writes results into result/.
- No built-in network calls, cloud services, or databases.

## Diagram (Mermaid)

```mermaid
graph TD
    User["User / CLI"]:::user
    README["README.md"]:::docs
    Dependencies["dependencies/"]:::deps
    Filesystem["Filesystem"]:::fs
    Beacon["Source Beacon (.exe)"]:::fs
    Result["result/ Output Dir"]:::fs

    subgraph "Python Runtime / obfuscadaptix.py"
        Main["obfuscadaptix.py"]:::core
        Parser["Argument Parser"]:::core
        Engine["Obfuscation Engine"]:::core
        subgraph "Transformation Modules"
            TM1["Import Table Mangling"]:::plugin
            TM2["Section Encryption"]:::plugin
            TM3["Code Injection"]:::plugin
        end
        IO["File I/O Module"]:::io
    end

    User -->|"invokes command"| Main
    User -->|"reads overview"| README
    Main -->|"parses -f [path]"| Parser
    Parser -->|"validated input path"| Engine
    Dependencies -->|"plugin discovery"| Engine

    Engine -->|"apply Import Table Mangling"| TM1
    TM1 -->|"module output"| Engine
    Engine -->|"apply Section Encryption"| TM2
    TM2 -->|"module output"| Engine
    Engine -->|"apply Code Injection"| TM3
    TM3 -->|"module output"| Engine

    Engine -->|"invoke File I/O"| IO
    IO -->|"load binary"| Beacon
    IO -->|"write obfuscated exe & DLL"| Result

    classDef core fill:#D6EAF8,stroke:#2980B9,color:#154360;
    classDef io fill:#D5F5E3,stroke:#27AE60,color:#145A32;
    classDef plugin fill:#FCF3CF,stroke:#F1C40F,color:#7D6608;
    classDef deps fill:#FADBD8,stroke:#E74C3C,color:#641E16;
    classDef fs fill:#EBDEF0,stroke:#8E44AD,color:#4A235A;
    classDef user fill:#F2F3F4,stroke:#A6ACAF,color:#616A6B;
    classDef docs fill:#FEF9E7,stroke:#F7DC6F,color:#7E5109;

    click Main "https://github.com/coili/obfuscadaptix/blob/main/obfuscadaptix.py"
    click Parser "https://github.com/coili/obfuscadaptix/blob/main/obfuscadaptix.py"
    click Engine "https://github.com/coili/obfuscadaptix/blob/main/obfuscadaptix.py"
    click IO "https://github.com/coili/obfuscadaptix/blob/main/obfuscadaptix.py"
    click Dependencies "https://github.com/coili/obfuscadaptix/tree/main/dependencies/"
    click README "https://github.com/coili/obfuscadaptix/blob/main/README.md"
    click Result "https://github.com/coili/obfuscadaptix/tree/main/result/"
```
