# karma-red-team/bruce-scripts-heaven architecture

> Architecture diagram of the GitHub repository karma-red-team/bruce-scripts-heaven, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/karma-red-team/bruce-scripts-heaven
- Repository: https://github.com/karma-red-team/bruce-scripts-heaven

## Overview

Bruce Scripts Heaven is presented as a community collection of device scripts, not a single integrated application. The README names RFID, NFC, IR and Sub-GHz capabilities, but the supplied tree and source excerpts do not identify their implementations or a shared runtime, so those features are not assigned speculative components or links. The visible tree instead contains BadUSB/Ducky payloads, BashBunny payloads, Malduino scripts and assorted standalone tools; their execution relationships are not established by the sampled evidence.

Main entry points: [`BruceBAD/BadUSB-FalsePhilosopher`](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher) (BadUSB Payloads), [`BruceBAD/BadUSB-FalsePhilosopher/Malduino/Library/DuckyDuino`](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Malduino/Library/DuckyDuino) (Malduino Scripts), [`BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky`](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky) (Ducky Payloads), [`BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library`](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library) (BashBunny Library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device_payloads["Device Payloads"]
  node_payload_collection["BadUSB Payloads"]
  node_malduino_scripts["Malduino Scripts"]
end

subgraph group_duck_scripts["Ducky Scripts"]
  node_ducky_library["Ducky Payloads"]
  node_ducky_execution["Execution Payloads"]
  node_ducky_exfiltration["Exfiltration Payloads"]
  node_ducky_remote["Remote Access"]
  node_ducky_pranks["Prank Payloads"]
end

subgraph group_bunny_scripts["BashBunny Scripts"]
  node_bunny_library["BashBunny Library"]
  node_bunny_manager["Bunny Manager<br/>[main.py]"]
  node_nic_sharing["NIC Sharing Server<br/>[server.py]"]
end

subgraph group_misc_tools["Standalone Tools"]
  node_osripper["OSRipper Tool<br/>[main.py]"]
  node_toolbox_file_manager["Toolbox File Manager<br/>[file_manager.py]"]
  node_piano_player["Piano Player<br/>[piano_player.py]"]
end

node_user(("Script User"))

node_user -->|"selects from"| node_payload_collection
node_user -->|"selects from"| node_bunny_library
node_user -->|"selects from"| node_ducky_library
node_user -->|"selects from"| node_malduino_scripts
node_user -->|"runs"| node_osripper
node_user -->|"uses"| node_toolbox_file_manager
node_user -->|"runs"| node_piano_player

click node_payload_collection "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher"
click node_bunny_library "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library"
click node_bunny_manager "https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library/general/BashBunny_Manager/panel/main.py"
click node_nic_sharing "https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library/general/Windows_NIC_Sharing/server.py"
click node_ducky_library "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky"
click node_ducky_execution "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/execution"
click node_ducky_exfiltration "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/exfiltration"
click node_ducky_remote "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/remote_access"
click node_ducky_pranks "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/prank"
click node_malduino_scripts "https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Malduino/Library/DuckyDuino"
click node_osripper "https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/remote_access/Unix-like/OSX/OSRipper/main.py"
click node_toolbox_file_manager "https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/Misc/Web/Toolbox/toolbox/server/file_manager.py"
click node_piano_player "https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/Piano_Player/piano_player.py"

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_payload_collection,node_malduino_scripts,node_user toneBlue
class node_ducky_library,node_ducky_execution,node_ducky_exfiltration,node_ducky_remote,node_ducky_pranks toneAmber
class node_bunny_library,node_bunny_manager,node_nic_sharing toneMint
class node_osripper,node_toolbox_file_manager,node_piano_player toneRose
```

## Components

### Device Payloads

- [BadUSB Payloads](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher): `BruceBAD/BadUSB-FalsePhilosopher`
- [Malduino Scripts](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Malduino/Library/DuckyDuino): `BruceBAD/BadUSB-FalsePhilosopher/Malduino/Library/DuckyDuino`

### Ducky Scripts

- [Ducky Payloads](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky): `BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky`
- [Execution Payloads](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/execution): `BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/execution`
- [Exfiltration Payloads](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/exfiltration): `BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/exfiltration`
- [Remote Access](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/remote_access): `BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/remote_access`
- [Prank Payloads](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/prank): `BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/prank`

### BashBunny Scripts

- [BashBunny Library](https://github.com/karma-red-team/bruce-scripts-heaven/tree/Main/BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library): `BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library`
- [Bunny Manager](https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library/general/BashBunny_Manager/panel/main.py): `BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library/general/BashBunny_Manager/panel/main.py`
- [NIC Sharing Server](https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library/general/Windows_NIC_Sharing/server.py): `BruceBAD/BadUSB-FalsePhilosopher/BashBunny/payloads/library/general/Windows_NIC_Sharing/server.py`

### Standalone Tools

- [OSRipper Tool](https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/remote_access/Unix-like/OSX/OSRipper/main.py): `BruceBAD/BadUSB-FalsePhilosopher/Ducky/USBRubberducky/remote_access/Unix-like/OSX/OSRipper/main.py`
- [Toolbox File Manager](https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/BadUSB-FalsePhilosopher/Misc/Web/Toolbox/toolbox/server/file_manager.py): `BruceBAD/BadUSB-FalsePhilosopher/Misc/Web/Toolbox/toolbox/server/file_manager.py`
- [Piano Player](https://github.com/karma-red-team/bruce-scripts-heaven/blob/Main/BruceBAD/Piano_Player/piano_player.py): `BruceBAD/Piano_Player/piano_player.py`

### Other components

- **Script User**

## Connections

- Script User → BadUSB Payloads: selects from
- Script User → BashBunny Library: selects from
- Script User → Ducky Payloads: selects from
- Script User → Malduino Scripts: selects from
- Script User → OSRipper Tool: runs
- Script User → Toolbox File Manager: uses
- Script User → Piano Player: runs