# quadvecta/stego architecture

> Architecture diagram of the GitHub repository quadvecta/stego, 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/quadvecta/stego
- Repository: https://github.com/quadvecta/stego

## Overview

STEGO is a desktop app for hiding encrypted messages in images. The documented workflow starts in the Tkinter interface: a message is encrypted, encoded, and embedded in a carrier image; decoding extracts the data, decodes it, and decrypts it. The README also documents key derivation, file dialogs, background work, notifications, and sharing. Only the README was available as evidence, so the graph reflects documented relationships rather than inspected implementation details.

Main entry points: [`stego_v1.051`](https://github.com/quadvecta/stego/blob/main/stego_v1.051) (Tkinter interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_ui["Tkinter interface<br/>[stego_v1.051]"]
  node_encode["Encode workflow<br/>[stego_v1.051]"]
  node_decode["Decode workflow<br/>[stego_v1.051]"]
  node_dialogs["Native file dialogs<br/>[stego_v1.051]"]
end

subgraph group_crypto["Encryption and keys"]
  node_derive["PBKDF2 derivation<br/>[stego_v1.051]"]
  node_encrypt["Fernet encryption<br/>[stego_v1.051]"]
  node_b64encode["Base64 encoding<br/>[stego_v1.051]"]
  node_b64decode["Base64 decoding<br/>[stego_v1.051]"]
  node_decrypt["Fernet decryption<br/>[stego_v1.051]"]
  node_keytoken["Key token<br/>[stego_v1.051]"]
end

subgraph group_steganography["Image steganography"]
  node_embed["2-LSB embedding<br/>[stego_v1.051]"]
  node_extract["Data extraction<br/>[stego_v1.051]"]
  node_output["Encrypted image"]
end

subgraph group_platform["Platform integrations"]
  node_share["OS sharing<br/>[stego_v1.051]"]
  node_notify["Native notifications<br/>[stego_v1.051]"]
end

node_user(("User"))
node_message["Secret message"]
node_carrier["Carrier image"]
node_os(("Operating system"))
node_file["Saved key file"]

node_user -->|"uses"| node_ui
node_ui -->|"starts encode"| node_encode
node_ui -->|"starts decode"| node_decode
node_user -->|"provides"| node_message
node_user -->|"chooses"| node_carrier
node_encode -->|"derives key"| node_derive
node_derive -->|"produces"| node_keytoken
node_encode -->|"encrypts message"| node_encrypt
node_encrypt -->|"encodes ciphertext"| node_b64encode
node_encode -->|"embeds data"| node_embed
node_b64encode -->|"provides payload"| node_embed
node_carrier -->|"provides image"| node_embed
node_embed -->|"produces"| node_output
node_decode -->|"extracts data"| node_extract
node_output -->|"provides image"| node_extract
node_extract -->|"provides payload"| node_b64decode
node_b64decode -->|"provides ciphertext"| node_decrypt
node_keytoken -->|"provides key"| node_decrypt
node_decode -->|"decrypts extracted data"| node_decrypt
node_ui -->|"uses dialogs"| node_dialogs
node_ui -->|"offers sharing"| node_share
node_share -->|"opens share options"| node_os
node_ui -->|"shows notifications"| node_notify
node_ui -->|"saves key token"| node_file

click node_ui "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_encode "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_decode "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_dialogs "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_derive "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_encrypt "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_b64encode "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_b64decode "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_decrypt "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_keytoken "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_embed "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_extract "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_share "https://github.com/quadvecta/stego/blob/main/stego_v1.051"
click node_notify "https://github.com/quadvecta/stego/blob/main/stego_v1.051"

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_ui,node_encode,node_decode,node_dialogs,node_user toneBlue
class node_derive,node_encrypt,node_b64encode,node_b64decode,node_decrypt,node_keytoken toneAmber
class node_embed,node_extract,node_output toneMint
class node_share,node_notify toneRose
class node_message,node_carrier,node_os,node_file toneIndigo
```

## Components

### Desktop interface

- [Tkinter interface](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Encode workflow](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Decode workflow](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Native file dialogs](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`

### Encryption and keys

- [PBKDF2 derivation](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Fernet encryption](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Base64 encoding](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Base64 decoding](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Fernet decryption](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Key token](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`

### Image steganography

- [2-LSB embedding](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Data extraction](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- **Encrypted image**

### Platform integrations

- [OS sharing](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`
- [Native notifications](https://github.com/quadvecta/stego/blob/main/stego_v1.051): `stego_v1.051`

### Other components

- **User**
- **Secret message**
- **Carrier image**
- **Operating system**
- **Saved key file**

## Connections

- User → Tkinter interface: uses (evidence: `README.md`)
- Tkinter interface → Encode workflow: starts encode (evidence: `README.md`)
- Tkinter interface → Decode workflow: starts decode (evidence: `README.md`)
- User → Secret message: provides (evidence: `README.md`)
- User → Carrier image: chooses (evidence: `README.md`)
- Encode workflow → PBKDF2 derivation: derives key (evidence: `README.md`)
- PBKDF2 derivation → Key token: produces (evidence: `README.md`)
- Encode workflow → Fernet encryption: encrypts message (evidence: `README.md`)
- Fernet encryption → Base64 encoding: encodes ciphertext (evidence: `README.md`)
- Encode workflow → 2-LSB embedding: embeds data (evidence: `README.md`)
- Base64 encoding → 2-LSB embedding: provides payload (evidence: `README.md`)
- Carrier image → 2-LSB embedding: provides image (evidence: `README.md`)
- 2-LSB embedding → Encrypted image: produces (evidence: `README.md`)
- Decode workflow → Data extraction: extracts data (evidence: `README.md`)
- Encrypted image → Data extraction: provides image (evidence: `README.md`)
- Data extraction → Base64 decoding: provides payload (evidence: `README.md`)
- Base64 decoding → Fernet decryption: provides ciphertext (evidence: `README.md`)
- Key token → Fernet decryption: provides key (evidence: `README.md`)
- Decode workflow → Fernet decryption: decrypts extracted data (evidence: `README.md`)
- Tkinter interface → Native file dialogs: uses dialogs (evidence: `README.md`)
- Tkinter interface → OS sharing: offers sharing (evidence: `README.md`)
- OS sharing → Operating system: opens share options (evidence: `README.md`)
- Tkinter interface → Native notifications: shows notifications (evidence: `README.md`)
- Tkinter interface → Saved key file: saves key token (evidence: `README.md`)
