# timothylee58/video-steganograhy-using-lsb-web-app architecture

> Architecture diagram of the GitHub repository timothylee58/video-steganograhy-using-lsb-web-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/timothylee58/video-steganograhy-using-lsb-web-app
- Repository: https://github.com/timothylee58/video-steganograhy-using-lsb-web-app

## Overview

VidStega is a Flask application for hiding password-encrypted messages in video frames and extracting them later. The main workflow submits a video and operation through the web/API layer, runs the shared pipeline synchronously or through Celery, processes frames with video, cryptography, and LSB services, and returns an output video. Capacity estimation, AI-assisted frame selection, batch processing, live progress, and metrics are additional capabilities. The README documents OAuth/JWT, but the supplied tree has no corresponding implementation modules; those are not mapped. Some connections are omitted where excerpts do not establish callers.

Main entry points: [`app/tasks.py`](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/tasks.py) (Task pipelines), [`app/routes.py`](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/routes.py) (REST routes), [`app/services/video_service.py`](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/video_service.py) (Video processing), [`app/services/batch_service.py`](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/batch_service.py) (Batch jobs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_webui["Web UI<br/>[index.html]"]
  node_appfactory["App factory<br/>[__init__.py]"]
  node_api["REST routes<br/>[routes.py]"]
  node_uploadstore["Video files<br/>[config.py]"]
end

subgraph group_processing["Job processing"]
  node_queue["Redis queue"]
  node_tasks["Task pipelines<br/>[tasks.py]"]
  node_batch["Batch jobs<br/>[batch_service.py]"]
  node_websocket["Progress events<br/>[websocket.py]"]
end

subgraph group_media["Media and payload"]
  node_video["Video processing<br/>[video_service.py]"]
  node_crypto["AES and PBKDF2<br/>[crypto_service.py]"]
  node_stego["LSB and ECC"]
  node_ai["AI frame analysis<br/>[ai_service.py]"]
  node_metadata["Video metadata"]
end

subgraph group_operations["Operations"]
  node_metrics["Pipeline metrics<br/>[metrics.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_webui
node_webui -.->|"submits jobs"| node_api
node_appfactory -->|"registers routes"| node_api
node_api -->|"locates uploads"| node_uploadstore
node_api -->|"dispatches or runs"| node_tasks
node_tasks -->|"enqueues"| node_queue
node_tasks -->|"reads and writes"| node_video
node_tasks -->|"encrypts and decrypts"| node_crypto
node_tasks -->|"embeds and extracts"| node_stego
node_tasks -->|"analyzes frames"| node_ai
node_tasks -->|"records runs"| node_metrics
node_batch -->|"reads and writes"| node_video
node_batch -->|"encrypts payload"| node_crypto
node_batch -->|"embeds payload"| node_stego
node_tasks -.->|"reports progress"| node_websocket
node_webui -.->|"receives updates"| node_websocket
node_api -.->|"estimates capacity"| node_video
node_video -.->|"reads metadata"| node_metadata

click node_webui "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/templates/index.html"
click node_appfactory "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/__init__.py"
click node_api "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/routes.py"
click node_uploadstore "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/config.py"
click node_tasks "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/tasks.py"
click node_batch "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/batch_service.py"
click node_websocket "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/websocket.py"
click node_video "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/video_service.py"
click node_crypto "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/crypto_service.py"
click node_stego "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/steganography_service.py"
click node_ai "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/ai_service.py"
click node_metadata "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/metadata_service.py"
click node_metrics "https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/metrics.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_webui,node_appfactory,node_api,node_uploadstore,node_user toneBlue
class node_queue,node_tasks,node_batch,node_websocket toneAmber
class node_video,node_crypto,node_stego,node_ai,node_metadata toneMint
class node_metrics toneRose
```

## Components

### Web interface

- [Web UI](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/templates/index.html): `templates/index.html`
- [App factory](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/__init__.py): `app/__init__.py`
- [REST routes](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/routes.py): `app/routes.py`
- [Video files](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/config.py): `app/config.py`

### Job processing

- **Redis queue**
- [Task pipelines](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/tasks.py): `app/tasks.py`
- [Batch jobs](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/batch_service.py): `app/services/batch_service.py`
- [Progress events](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/websocket.py): `app/websocket.py`

### Media and payload

- [Video processing](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/video_service.py): `app/services/video_service.py`
- [AES and PBKDF2](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/crypto_service.py): `app/services/crypto_service.py`
- [LSB and ECC](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/steganography_service.py): `app/services/steganography_service.py`
- [AI frame analysis](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/ai_service.py): `app/services/ai_service.py`
- [Video metadata](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/services/metadata_service.py): `app/services/metadata_service.py`

### Operations

- [Pipeline metrics](https://github.com/timothylee58/video-steganograhy-using-lsb-web-app/blob/master/app/metrics.py): `app/metrics.py`

### Other components

- **User**

## Connections

- User → Web UI: uses (evidence: `README.md`)
- Web UI → REST routes: submits jobs
- App factory → REST routes: registers routes (evidence: `app/__init__.py`)
- REST routes → Video files: locates uploads (evidence: `app/routes.py`)
- REST routes → Task pipelines: dispatches or runs (evidence: `app/routes.py`)
- Task pipelines → Redis queue: enqueues (evidence: `README.md`)
- Task pipelines → Video processing: reads and writes (evidence: `app/tasks.py`)
- Task pipelines → AES and PBKDF2: encrypts and decrypts (evidence: `app/tasks.py`)
- Task pipelines → LSB and ECC: embeds and extracts (evidence: `app/tasks.py`)
- Task pipelines → AI frame analysis: analyzes frames (evidence: `app/tasks.py`)
- Task pipelines → Pipeline metrics: records runs (evidence: `app/metrics.py`)
- Batch jobs → Video processing: reads and writes (evidence: `app/services/batch_service.py`)
- Batch jobs → AES and PBKDF2: encrypts payload (evidence: `app/services/batch_service.py`)
- Batch jobs → LSB and ECC: embeds payload (evidence: `app/services/batch_service.py`)
- Task pipelines → Progress events: reports progress
- Web UI → Progress events: receives updates
- REST routes → Video processing: estimates capacity (evidence: `app/routes.py`)
- Video processing → Video metadata: reads metadata
