# trufoox/honeywasp architecture

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

- Interactive diagram: https://gitdiagram.com/trufoox/honeywasp
- Repository: https://github.com/trufoox/honeywasp

## Overview

HoneyWasp is a locally run social-media posting bot. Its principal workflow is to load client-side settings, start a selected service, obtain media for an upload, and publish through that platform’s API; users can initiate and monitor it from the console or Discord. The graph also preserves the documented Reddit/Meme API media option and shared upload, cache, and output utilities. Some source was only indexed or excerpted, so uncertain runtime links are omitted rather than inferred.

Main entry points: [`src/main/java/services/Services.java`](https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Services.java) (Posting service loop), [`src/main/java/config/Config.java`](https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/Config.java) (Config loader), [`src/main/java/utils/HTTPSend.java`](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/HTTPSend.java) (HTTP utilities), [`src/main/java/services/Instagram.java`](https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Instagram.java) (Instagram publisher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Bot control"]
  node_console["Console commands<br/>[Command.java]"]
  node_discord["Discord bot<br/>[HoneyWasp.java]"]
  node_app["HoneyWasp runtime<br/>[HoneyWasp.java]"]
end

subgraph group_settings["Configuration"]
  node_config["Config loader<br/>[Config.java]"]
  node_general["General settings"]
  node_igconfig["Instagram settings"]
  node_ttconfig["TikTok settings"]
  node_ytconfig["YouTube settings"]
  node_twconfig["Twitter settings"]
end

subgraph group_publishing["Publishing services"]
  node_service["Posting service loop<br/>[Services.java]"]
  node_instagram["Instagram publisher<br/>[Instagram.java]"]
  node_tiktok["TikTok publisher<br/>[TikTok.java]"]
  node_youtube["YouTube publisher<br/>[YouTube.java]"]
  node_twitter["Twitter integration<br/>[Twitter.java]"]
end

subgraph group_runtime["Shared runtime"]
  node_http["HTTP utilities<br/>[HTTPSend.java]"]
  node_files["File and cache I/O<br/>[FileIO.java]"]
  node_media["Image video conversion<br/>[ImageToVideo.java]"]
  node_output["Console webhook output<br/>[Output.java]"]
  node_webhook["Discord webhook<br/>[Webhook.java]"]
  node_json["JSON parsing<br/>[StringToJson.java]"]
  node_sleep["Retry delays<br/>[Sleep.java]"]
end

node_user(("Operator"))
node_reddit["Reddit Meme API"]
node_platforms["Social platform APIs"]

node_user -->|"starts"| node_app
node_user -->|"enters commands"| node_console
node_user -->|"sends commands"| node_discord
node_console -->|"controls"| node_app
node_app -->|"loads"| node_config
node_app -->|"starts services"| node_service
node_config -->|"loads settings"| node_general
node_config -->|"loads settings"| node_igconfig
node_config -->|"loads settings"| node_ttconfig
node_config -->|"loads settings"| node_ytconfig
node_config -.->|"loads settings"| node_twconfig
node_service -.->|"dispatches"| node_instagram
node_service -.->|"dispatches"| node_tiktok
node_service -.->|"dispatches"| node_youtube
node_service -.->|"dispatches"| node_twitter
node_reddit -->|"provides media"| node_service
node_service -->|"converts media"| node_media
node_service -->|"uploads media"| node_http
node_service -->|"reads and caches"| node_files
node_service -->|"waits between attempts"| node_sleep
node_instagram -->|"sends requests"| node_http
node_instagram -->|"parses responses"| node_json
node_instagram -->|"publishes media"| node_platforms
node_tiktok -->|"requests tokens"| node_http
node_tiktok -->|"parses responses"| node_json
node_tiktok -->|"uploads video"| node_platforms
node_youtube -->|"requests tokens"| node_http
node_youtube -->|"parses responses"| node_json
node_youtube -->|"uploads video"| node_platforms
node_twitter -->|"uses HTTP"| node_http
node_output -->|"sends messages"| node_webhook
node_service -->|"reports status"| node_output

click node_console "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Command.java"
click node_discord "https://github.com/trufoox/honeywasp/blob/master/src/main/java/main/HoneyWasp.java"
click node_app "https://github.com/trufoox/honeywasp/blob/master/src/main/java/main/HoneyWasp.java"
click node_config "https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/Config.java"
click node_general "https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/GeneralSettings.java"
click node_igconfig "https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/InstagramSettings.java"
click node_ttconfig "https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/TiktokSettings.java"
click node_ytconfig "https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/YoutubeSettings.java"
click node_twconfig "https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/TwitterSettings.java"
click node_service "https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Services.java"
click node_instagram "https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Instagram.java"
click node_tiktok "https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/TikTok.java"
click node_youtube "https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/YouTube.java"
click node_twitter "https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Twitter.java"
click node_http "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/HTTPSend.java"
click node_files "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/FileIO.java"
click node_media "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/ImageToVideo.java"
click node_output "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Output.java"
click node_webhook "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Webhook.java"
click node_json "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/StringToJson.java"
click node_sleep "https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Sleep.java"

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_console,node_discord,node_app toneBlue
class node_config,node_general,node_igconfig,node_ttconfig,node_ytconfig,node_twconfig toneAmber
class node_service,node_instagram,node_tiktok,node_youtube,node_twitter,node_reddit,node_platforms toneMint
class node_http,node_files,node_media,node_output,node_webhook,node_json,node_sleep toneRose
class node_user toneIndigo
```

## Components

### Bot control

- [Console commands](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Command.java): `src/main/java/utils/Command.java`
- [Discord bot](https://github.com/trufoox/honeywasp/blob/master/src/main/java/main/HoneyWasp.java): `src/main/java/main/HoneyWasp.java`
- [HoneyWasp runtime](https://github.com/trufoox/honeywasp/blob/master/src/main/java/main/HoneyWasp.java): `src/main/java/main/HoneyWasp.java`

### Configuration

- [Config loader](https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/Config.java): `src/main/java/config/Config.java`
- [General settings](https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/GeneralSettings.java): `src/main/java/config/GeneralSettings.java`
- [Instagram settings](https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/InstagramSettings.java): `src/main/java/config/InstagramSettings.java`
- [TikTok settings](https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/TiktokSettings.java): `src/main/java/config/TiktokSettings.java`
- [YouTube settings](https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/YoutubeSettings.java): `src/main/java/config/YoutubeSettings.java`
- [Twitter settings](https://github.com/trufoox/honeywasp/blob/master/src/main/java/config/TwitterSettings.java): `src/main/java/config/TwitterSettings.java`

### Publishing services

- [Posting service loop](https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Services.java): `src/main/java/services/Services.java`
- [Instagram publisher](https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Instagram.java): `src/main/java/services/Instagram.java`
- [TikTok publisher](https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/TikTok.java): `src/main/java/services/TikTok.java`
- [YouTube publisher](https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/YouTube.java): `src/main/java/services/YouTube.java`
- [Twitter integration](https://github.com/trufoox/honeywasp/blob/master/src/main/java/services/Twitter.java): `src/main/java/services/Twitter.java`

### Shared runtime

- [HTTP utilities](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/HTTPSend.java): `src/main/java/utils/HTTPSend.java`
- [File and cache I/O](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/FileIO.java): `src/main/java/utils/FileIO.java`
- [Image video conversion](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/ImageToVideo.java): `src/main/java/utils/ImageToVideo.java`
- [Console webhook output](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Output.java): `src/main/java/utils/Output.java`
- [Discord webhook](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Webhook.java): `src/main/java/utils/Webhook.java`
- [JSON parsing](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/StringToJson.java): `src/main/java/utils/StringToJson.java`
- [Retry delays](https://github.com/trufoox/honeywasp/blob/master/src/main/java/utils/Sleep.java): `src/main/java/utils/Sleep.java`

### Other components

- **Operator**
- **Reddit Meme API**
- **Social platform APIs**

## Connections

- Operator → HoneyWasp runtime: starts (evidence: `README.md`)
- Operator → Console commands: enters commands (evidence: `README.md`)
- Operator → Discord bot: sends commands (evidence: `README.md`)
- Console commands → HoneyWasp runtime: controls (evidence: `src/main/java/utils/Command.java`)
- HoneyWasp runtime → Config loader: loads (evidence: `src/main/java/main/HoneyWasp.java`)
- HoneyWasp runtime → Posting service loop: starts services (evidence: `src/main/java/main/HoneyWasp.java`)
- Config loader → General settings: loads settings (evidence: `src/main/java/config/Config.java`)
- Config loader → Instagram settings: loads settings (evidence: `src/main/java/config/Config.java`)
- Config loader → TikTok settings: loads settings (evidence: `src/main/java/config/Config.java`)
- Config loader → YouTube settings: loads settings (evidence: `src/main/java/config/Config.java`)
- Config loader → Twitter settings: loads settings
- Posting service loop → Instagram publisher: dispatches (evidence: `src/main/java/services/Instagram.java`)
- Posting service loop → TikTok publisher: dispatches (evidence: `src/main/java/services/TikTok.java`)
- Posting service loop → YouTube publisher: dispatches (evidence: `src/main/java/services/YouTube.java`)
- Posting service loop → Twitter integration: dispatches
- Reddit Meme API → Posting service loop: provides media (evidence: `README.md`)
- Posting service loop → Image video conversion: converts media (evidence: `src/main/java/services/Services.java`)
- Posting service loop → HTTP utilities: uploads media (evidence: `src/main/java/services/Services.java`)
- Posting service loop → File and cache I/O: reads and caches (evidence: `src/main/java/services/Services.java`)
- Posting service loop → Retry delays: waits between attempts (evidence: `src/main/java/services/Services.java`)
- Instagram publisher → HTTP utilities: sends requests (evidence: `src/main/java/services/Instagram.java`)
- Instagram publisher → JSON parsing: parses responses (evidence: `src/main/java/services/Instagram.java`)
- Instagram publisher → Social platform APIs: publishes media (evidence: `src/main/java/services/Instagram.java`)
- TikTok publisher → HTTP utilities: requests tokens (evidence: `src/main/java/services/TikTok.java`)
- TikTok publisher → JSON parsing: parses responses (evidence: `src/main/java/services/TikTok.java`)
- TikTok publisher → Social platform APIs: uploads video (evidence: `src/main/java/services/TikTok.java`)
- YouTube publisher → HTTP utilities: requests tokens (evidence: `src/main/java/services/YouTube.java`)
- YouTube publisher → JSON parsing: parses responses (evidence: `src/main/java/services/YouTube.java`)
- YouTube publisher → Social platform APIs: uploads video (evidence: `src/main/java/services/YouTube.java`)
- Twitter integration → HTTP utilities: uses HTTP (evidence: `src/main/java/services/Twitter.java`)
- Console webhook output → Discord webhook: sends messages (evidence: `src/main/java/utils/Output.java`)
- Posting service loop → Console webhook output: reports status (evidence: `src/main/java/services/Services.java`)
