# sahir247/veilframe architecture

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

## Overview

VeilFrame is an offline-first multimedia workstation spanning desktop and Android. Users select a workspace and media or project input; the relevant compiler, studio, scanner, or bundler processes it and produces an export, report, or scan result. The graph preserves the documented privacy, creative, forensic, and developer-tool branches. Edges cite README-level capability descriptions or source-index references; several implementations were not sampled, so their internal calls are intentionally omitted.

Main entry points: [`veilframe/core/pipeline.py`](https://github.com/sahir247/veilframe/blob/main/veilframe/core/pipeline.py) (Video Cleaner), [`android/app/src/main/java/com/veilframe/app/MainActivity.kt`](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/MainActivity.kt) (Android Workspaces), [`android/app/src/main/java/com/veilframe/app/qr/ui/QrStudioFragment.kt`](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/ui/QrStudioFragment.kt) (QR Studio), [`veilframe/gui/main_window.py`](https://github.com/sahir247/veilframe/blob/main/veilframe/gui/main_window.py) (Desktop Workspaces)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop_privacy["Desktop Privacy"]
  node_video_pipeline["Video Cleaner<br/>[pipeline.py]"]
  node_video_analyzer["Video Analyzer<br/>[analyzer.py]"]
  node_video_encoder["Video Encoder<br/>[encoder.py]"]
  node_video_sanitizer["Video Sanitizer<br/>[sanitizer.py]"]
  node_quality_gate["Quality Gate<br/>[gate.py]"]
  node_video_report["Verification Report<br/>[verifier.py]"]
end

subgraph group_image_privacy["Image Privacy"]
  node_image_pipeline["Image Compiler<br/>[pipeline.py]"]
  node_image_redteam["Red-Team Probes<br/>[engine.py]"]
  node_image_publisher["Image Publisher<br/>[publisher.py]"]
end

subgraph group_folder_tools["Folder Intelligence"]
  node_folder_scanner["Folder Scanner<br/>[scanner.py]"]
  node_folder_metadata["Metadata Engine<br/>[metadata_engine.py]"]
  node_folder_database[("Scan Database<br/>[folder_db.py]")]
  node_bundle_builder["Context Bundler<br/>[bundle_builder.py]"]
  node_bundle_json["JSON Bundle Renderer<br/>[json.py]"]
end

subgraph group_android_studios["Android Studios"]
  node_qr_studio["QR Studio"]
  node_qr_design["QR Design Model<br/>[QrDesign.kt]"]
  node_qr_icon["QR Logo Pipeline"]
  node_qr_scanner["QR Scanner<br/>[QrScanner.kt]"]
  node_upscale_ui["Upscaler"]
  node_upscale_engine["Upscale Inference"]
  node_video_studio["Video Studio"]
  node_status_pipeline["Status Export"]
  node_image_studio["Image Studio"]
  node_markdown_studio["Markdown Studio"]
end

subgraph group_shared_app["Application Shell"]
  node_desktop_ui["Desktop Workspaces<br/>[main_window.py]"]
  node_android_app["Android Workspaces<br/>[MainActivity.kt]"]
end

node_user(("User"))
node_media_input["Media / Project"]
node_media_output["Processed Export"]
node_onnx["ONNX Runtime"]
node_camera["Device Camera"]

node_user -->|"selects workspace"| node_desktop_ui
node_desktop_ui -->|"starts processing"| node_video_pipeline
node_video_pipeline -->|"analyzes input"| node_video_analyzer
node_video_pipeline -->|"sanitizes container"| node_video_sanitizer
node_video_pipeline -->|"encodes media"| node_video_encoder
node_video_pipeline -->|"audits fidelity"| node_quality_gate
node_video_pipeline -->|"verifies export"| node_video_report
node_video_pipeline -->|"reads media"| node_media_input
node_video_pipeline -->|"writes export"| node_media_output
node_desktop_ui -->|"starts compilation"| node_image_pipeline
node_image_pipeline -->|"runs probes"| node_image_redteam
node_image_pipeline -->|"publishes result"| node_image_publisher
node_user -->|"chooses directory"| node_folder_scanner
node_folder_scanner -->|"extracts metadata"| node_folder_metadata
node_folder_scanner -.->|"stores scan"| node_folder_database
node_desktop_ui -->|"configures bundle"| node_bundle_builder
node_bundle_builder -->|"renders JSON"| node_bundle_json
node_user -->|"opens workspace"| node_android_app
node_android_app -->|"opens QR studio"| node_qr_studio
node_qr_studio -->|"configures design"| node_qr_design
node_qr_studio -->|"renders logo"| node_qr_icon
node_qr_studio -->|"scans codes"| node_qr_scanner
node_camera -->|"provides frames"| node_qr_scanner
node_android_app -->|"opens upscaler"| node_upscale_ui
node_upscale_ui -->|"runs inference"| node_upscale_engine
node_upscale_engine -->|"uses runtime"| node_onnx
node_android_app -->|"opens video studio"| node_video_studio
node_video_studio -.->|"exports status"| node_status_pipeline
node_android_app -->|"opens image studio"| node_image_studio
node_android_app -->|"opens Markdown"| node_markdown_studio

click node_desktop_ui "https://github.com/sahir247/veilframe/blob/main/veilframe/gui/main_window.py"
click node_video_pipeline "https://github.com/sahir247/veilframe/blob/main/veilframe/core/pipeline.py"
click node_video_analyzer "https://github.com/sahir247/veilframe/blob/main/veilframe/core/analyzer.py"
click node_video_encoder "https://github.com/sahir247/veilframe/blob/main/veilframe/core/encoder.py"
click node_video_sanitizer "https://github.com/sahir247/veilframe/blob/main/veilframe/core/sanitizer.py"
click node_quality_gate "https://github.com/sahir247/veilframe/blob/main/veilframe/quality/gate.py"
click node_video_report "https://github.com/sahir247/veilframe/blob/main/veilframe/core/verifier.py"
click node_image_pipeline "https://github.com/sahir247/veilframe/blob/main/veilframe/image/pipeline.py"
click node_image_redteam "https://github.com/sahir247/veilframe/blob/main/veilframe/image/redteam/engine.py"
click node_image_publisher "https://github.com/sahir247/veilframe/blob/main/veilframe/image/publisher.py"
click node_folder_scanner "https://github.com/sahir247/veilframe/blob/main/veilframe/folder/scanner/scanner.py"
click node_folder_metadata "https://github.com/sahir247/veilframe/blob/main/veilframe/folder/metadata/metadata_engine.py"
click node_folder_database "https://github.com/sahir247/veilframe/blob/main/veilframe/folder/database/folder_db.py"
click node_bundle_builder "https://github.com/sahir247/veilframe/blob/main/veilframe/folder/ai_bundle/bundle_builder.py"
click node_bundle_json "https://github.com/sahir247/veilframe/blob/main/veilframe/folder/ai_bundle/formats/json.py"
click node_android_app "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/MainActivity.kt"
click node_qr_studio "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/ui/QrStudioFragment.kt"
click node_qr_design "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/model/QrDesign.kt"
click node_qr_icon "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/geometry/VeilIconPipeline.kt"
click node_qr_scanner "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/scanner/QrScanner.kt"
click node_upscale_ui "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/upscale/ui/ImageUpscalerController.kt"
click node_upscale_engine "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/upscale/inference/UpscaleInferenceEngine.kt"
click node_video_studio "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/media/VideoStudioController.kt"
click node_status_pipeline "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/media/whatsapp/WhatsappStatusMediaPipeline.kt"
click node_image_studio "https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/media/ImageStudioController.kt"
click node_markdown_studio "https://github.com/sahir247/veilframe/tree/main/android/app/src/main/java/com/veilframe/app/markdown"

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_video_pipeline,node_video_analyzer,node_video_encoder,node_video_sanitizer,node_quality_gate,node_video_report,node_user toneBlue
class node_image_pipeline,node_image_redteam,node_image_publisher toneAmber
class node_folder_scanner,node_folder_metadata,node_folder_database,node_bundle_builder,node_bundle_json toneMint
class node_qr_studio,node_qr_design,node_qr_icon,node_qr_scanner,node_upscale_ui,node_upscale_engine,node_video_studio,node_status_pipeline,node_image_studio,node_markdown_studio toneRose
class node_desktop_ui,node_android_app,node_media_input,node_media_output,node_onnx,node_camera toneIndigo
```

## Components

### Desktop Privacy

- [Video Cleaner](https://github.com/sahir247/veilframe/blob/main/veilframe/core/pipeline.py): `veilframe/core/pipeline.py`
- [Video Analyzer](https://github.com/sahir247/veilframe/blob/main/veilframe/core/analyzer.py): `veilframe/core/analyzer.py`
- [Video Encoder](https://github.com/sahir247/veilframe/blob/main/veilframe/core/encoder.py): `veilframe/core/encoder.py`
- [Video Sanitizer](https://github.com/sahir247/veilframe/blob/main/veilframe/core/sanitizer.py): `veilframe/core/sanitizer.py`
- [Quality Gate](https://github.com/sahir247/veilframe/blob/main/veilframe/quality/gate.py): `veilframe/quality/gate.py`
- [Verification Report](https://github.com/sahir247/veilframe/blob/main/veilframe/core/verifier.py): `veilframe/core/verifier.py`

### Image Privacy

- [Image Compiler](https://github.com/sahir247/veilframe/blob/main/veilframe/image/pipeline.py): `veilframe/image/pipeline.py`
- [Red-Team Probes](https://github.com/sahir247/veilframe/blob/main/veilframe/image/redteam/engine.py): `veilframe/image/redteam/engine.py`
- [Image Publisher](https://github.com/sahir247/veilframe/blob/main/veilframe/image/publisher.py): `veilframe/image/publisher.py`

### Folder Intelligence

- [Folder Scanner](https://github.com/sahir247/veilframe/blob/main/veilframe/folder/scanner/scanner.py): `veilframe/folder/scanner/scanner.py`
- [Metadata Engine](https://github.com/sahir247/veilframe/blob/main/veilframe/folder/metadata/metadata_engine.py): `veilframe/folder/metadata/metadata_engine.py`
- [Scan Database](https://github.com/sahir247/veilframe/blob/main/veilframe/folder/database/folder_db.py): `veilframe/folder/database/folder_db.py`
- [Context Bundler](https://github.com/sahir247/veilframe/blob/main/veilframe/folder/ai_bundle/bundle_builder.py): `veilframe/folder/ai_bundle/bundle_builder.py`
- [JSON Bundle Renderer](https://github.com/sahir247/veilframe/blob/main/veilframe/folder/ai_bundle/formats/json.py): `veilframe/folder/ai_bundle/formats/json.py`

### Android Studios

- [QR Studio](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/ui/QrStudioFragment.kt): `android/app/src/main/java/com/veilframe/app/qr/ui/QrStudioFragment.kt`
- [QR Design Model](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/model/QrDesign.kt): `android/app/src/main/java/com/veilframe/app/qr/model/QrDesign.kt`
- [QR Logo Pipeline](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/geometry/VeilIconPipeline.kt): `android/app/src/main/java/com/veilframe/app/qr/geometry/VeilIconPipeline.kt`
- [QR Scanner](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/qr/scanner/QrScanner.kt): `android/app/src/main/java/com/veilframe/app/qr/scanner/QrScanner.kt`
- [Upscaler](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/upscale/ui/ImageUpscalerController.kt): `android/app/src/main/java/com/veilframe/app/upscale/ui/ImageUpscalerController.kt`
- [Upscale Inference](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/upscale/inference/UpscaleInferenceEngine.kt): `android/app/src/main/java/com/veilframe/app/upscale/inference/UpscaleInferenceEngine.kt`
- [Video Studio](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/media/VideoStudioController.kt): `android/app/src/main/java/com/veilframe/app/media/VideoStudioController.kt`
- [Status Export](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/media/whatsapp/WhatsappStatusMediaPipeline.kt): `android/app/src/main/java/com/veilframe/app/media/whatsapp/WhatsappStatusMediaPipeline.kt`
- [Image Studio](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/media/ImageStudioController.kt): `android/app/src/main/java/com/veilframe/app/media/ImageStudioController.kt`
- [Markdown Studio](https://github.com/sahir247/veilframe/tree/main/android/app/src/main/java/com/veilframe/app/markdown): `android/app/src/main/java/com/veilframe/app/markdown`

### Application Shell

- [Desktop Workspaces](https://github.com/sahir247/veilframe/blob/main/veilframe/gui/main_window.py): `veilframe/gui/main_window.py`
- [Android Workspaces](https://github.com/sahir247/veilframe/blob/main/android/app/src/main/java/com/veilframe/app/MainActivity.kt): `android/app/src/main/java/com/veilframe/app/MainActivity.kt`

### Other components

- **User**
- **Media / Project**
- **Processed Export**
- **ONNX Runtime**
- **Device Camera**

## Connections

- User → Desktop Workspaces: selects workspace (evidence: `README.md`)
- Desktop Workspaces → Video Cleaner: starts processing (evidence: `README.md`)
- Video Cleaner → Video Analyzer: analyzes input (evidence: `veilframe/core/pipeline.py`)
- Video Cleaner → Video Sanitizer: sanitizes container (evidence: `veilframe/core/pipeline.py`)
- Video Cleaner → Video Encoder: encodes media (evidence: `veilframe/core/pipeline.py`)
- Video Cleaner → Quality Gate: audits fidelity (evidence: `veilframe/core/pipeline.py`)
- Video Cleaner → Verification Report: verifies export (evidence: `veilframe/core/pipeline.py`)
- Video Cleaner → Media / Project: reads media (evidence: `veilframe/core/pipeline.py`)
- Video Cleaner → Processed Export: writes export (evidence: `veilframe/core/pipeline.py`)
- Desktop Workspaces → Image Compiler: starts compilation (evidence: `README.md`)
- Image Compiler → Red-Team Probes: runs probes (evidence: `veilframe/image/pipeline.py`)
- Image Compiler → Image Publisher: publishes result (evidence: `veilframe/image/pipeline.py`)
- User → Folder Scanner: chooses directory (evidence: `README.md`)
- Folder Scanner → Metadata Engine: extracts metadata (evidence: `veilframe/folder/metadata/metadata_engine.py`)
- Folder Scanner → Scan Database: stores scan
- Desktop Workspaces → Context Bundler: configures bundle (evidence: `README.md`)
- Context Bundler → JSON Bundle Renderer: renders JSON (evidence: `veilframe/folder/ai_bundle/formats/json.py`)
- User → Android Workspaces: opens workspace (evidence: `README.md`)
- Android Workspaces → QR Studio: opens QR studio (evidence: `README.md`)
- QR Studio → QR Design Model: configures design (evidence: `android/app/src/main/java/com/veilframe/app/qr/model/QrDesign.kt`)
- QR Studio → QR Logo Pipeline: renders logo (evidence: `android/app/src/main/java/com/veilframe/app/qr/geometry/VeilIconPipeline.kt`)
- QR Studio → QR Scanner: scans codes (evidence: `README.md`)
- Device Camera → QR Scanner: provides frames (evidence: `README.md`)
- Android Workspaces → Upscaler: opens upscaler (evidence: `README.md`)
- Upscaler → Upscale Inference: runs inference (evidence: `android/app/src/main/java/com/veilframe/app/upscale/inference/UpscaleInferenceEngine.kt`)
- Upscale Inference → ONNX Runtime: uses runtime (evidence: `README.md`)
- Android Workspaces → Video Studio: opens video studio (evidence: `README.md`)
- Video Studio → Status Export: exports status
- Android Workspaces → Image Studio: opens image studio (evidence: `README.md`)
- Android Workspaces → Markdown Studio: opens Markdown (evidence: `README.md`)
