# sathees-waran/image-steganography-lsb-c architecture

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

- Interactive diagram: https://gitdiagram.com/sathees-waran/image-steganography-lsb-c
- Repository: https://github.com/sathees-waran/image-steganography-lsb-c

## Overview

This C command-line tool hides a secret file in a BMP using LSB encoding and reconstructs it in decode mode. The principal workflows are argument validation, encoding (capacity check, BMP header preservation, ordered metadata and payload embedding), and decoding (magic-string check, metadata extraction, and output reconstruction). The graph also shows the shared type definitions and the user-supplied magic-string check. Relationships are based on the sampled entry point and pipeline implementations plus README documentation; unsampled files were not inspected.

Main entry points: [`main.c`](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/main.c) (Mode dispatch), [`encode.c`](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c) (Encode driver), [`decode.c`](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c) (Decode driver), [`encode.h`](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.h) (Encode interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI dispatch"]
  node_main["Mode dispatch<br/>[main.c]"]
end

subgraph group_encode["Encoding"]
  node_encode_args["Encode arguments<br/>[encode.c]"]
  node_encoder["Encode driver<br/>[encode.c]"]
  node_capacity["Capacity and header<br/>[encode.c]"]
  node_embed["LSB embedding<br/>[encode.c]"]
end

subgraph group_decode["Decoding"]
  node_decode_args["Decode arguments<br/>[decode.c]"]
  node_decoder["Decode driver<br/>[decode.c]"]
  node_magic["Magic check<br/>[decode.c]"]
  node_extract["Metadata and data extraction<br/>[decode.c]"]
end

subgraph group_shared["Shared definitions"]
  node_encode_api["Encode interface<br/>[encode.h]"]
  node_decode_api["Decode interface<br/>[decode.h]"]
  node_types["Shared types<br/>[types.h]"]
  node_constants["Magic constant<br/>[common.h]"]
end

node_user(("CLI user"))
node_stego["Stego BMP"]
node_recovered["Recovered file"]
node_magic_input(("Magic-string input"))

node_user -->|"selects mode"| node_main
node_main -->|"validates encode"| node_encode_args
node_main -->|"dispatches decode"| node_decoder
node_main -->|"validates decode"| node_decode_args
node_encode_args -->|"passes configuration"| node_encoder
node_encoder -->|"checks capacity"| node_capacity
node_encoder -->|"embeds payload"| node_embed
node_capacity -->|"prepares output"| node_stego
node_embed -->|"writes encoded bytes"| node_stego
node_decoder -->|"checks signature"| node_magic
node_magic_input -->|"supplies expected string"| node_magic
node_decoder -->|"decodes fields"| node_extract
node_stego -->|"provides BMP"| node_decoder
node_extract -->|"writes recovered data"| node_recovered
node_main -->|"uses declarations"| node_encode_api
node_main -->|"uses declarations"| node_decode_api
node_encode_api -->|"uses shared types"| node_types
node_decode_api -->|"uses shared types"| node_types
node_encoder -->|"uses magic constant"| node_constants

click node_main "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/main.c"
click node_encode_args "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c"
click node_encoder "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c"
click node_capacity "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c"
click node_embed "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c"
click node_decode_args "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c"
click node_decoder "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c"
click node_magic "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c"
click node_extract "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c"
click node_encode_api "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.h"
click node_decode_api "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.h"
click node_types "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/types.h"
click node_constants "https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/common.h"

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_main,node_user toneBlue
class node_encode_args,node_encoder,node_capacity,node_embed toneAmber
class node_decode_args,node_decoder,node_magic,node_extract toneMint
class node_encode_api,node_decode_api,node_types,node_constants toneRose
class node_stego,node_recovered,node_magic_input toneIndigo
```

## Components

### CLI dispatch

- [Mode dispatch](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/main.c): `main.c`

### Encoding

- [Encode arguments](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c): `encode.c`
- [Encode driver](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c): `encode.c`
- [Capacity and header](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c): `encode.c`
- [LSB embedding](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.c): `encode.c`

### Decoding

- [Decode arguments](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c): `decode.c`
- [Decode driver](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c): `decode.c`
- [Magic check](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c): `decode.c`
- [Metadata and data extraction](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.c): `decode.c`

### Shared definitions

- [Encode interface](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/encode.h): `encode.h`
- [Decode interface](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/decode.h): `decode.h`
- [Shared types](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/types.h): `types.h`
- [Magic constant](https://github.com/sathees-waran/image-steganography-lsb-c/blob/main/common.h): `common.h`

### Other components

- **CLI user**
- **Stego BMP**
- **Recovered file**
- **Magic-string input**

## Connections

- CLI user → Mode dispatch: selects mode (evidence: `README.md`)
- Mode dispatch → Encode arguments: validates encode (evidence: `main.c`)
- Mode dispatch → Decode driver: dispatches decode (evidence: `main.c`)
- Mode dispatch → Decode arguments: validates decode (evidence: `main.c`)
- Encode arguments → Encode driver: passes configuration (evidence: `encode.c`)
- Encode driver → Capacity and header: checks capacity (evidence: `encode.c`)
- Encode driver → LSB embedding: embeds payload (evidence: `encode.c`)
- Capacity and header → Stego BMP: prepares output (evidence: `encode.c`)
- LSB embedding → Stego BMP: writes encoded bytes (evidence: `encode.c`)
- Decode driver → Magic check: checks signature (evidence: `decode.c`)
- Magic-string input → Magic check: supplies expected string (evidence: `decode.c`)
- Decode driver → Metadata and data extraction: decodes fields (evidence: `decode.c`)
- Stego BMP → Decode driver: provides BMP (evidence: `README.md`)
- Metadata and data extraction → Recovered file: writes recovered data (evidence: `decode.c`)
- Mode dispatch → Encode interface: uses declarations (evidence: `main.c`)
- Mode dispatch → Decode interface: uses declarations (evidence: `main.c`)
- Encode interface → Shared types: uses shared types (evidence: `encode.h`)
- Decode interface → Shared types: uses shared types (evidence: `decode.h`)
- Encode driver → Magic constant: uses magic constant (evidence: `encode.c`)
