# bridge-mind/bridgeclip architecture

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

## Overview

BridgeClip is a desktop app for turning local or online long-form videos into short, captioned clips. Users configure a workflow, submit a video, monitor processing, refine candidate edits when desired, and find exported clips in the Library or output folder. The engine transcribes and plans clip candidates, applies editorial checks, and renders locally; publishing and scheduling are separate capabilities through Zernio. The graph combines README-documented product flows with relationships visible in excerpts and the SOURCE INDEX; unsampled UI-to-handler details are not inferred.

Main entry points: [`src/renderer/App.tsx`](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/App.tsx) (App navigation), [`engine/clip_engine/services/ai_clipping_pipeline.py`](https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/ai_clipping_pipeline.py) (AI clipping pipeline), [`src/main/pipeline-runner.ts`](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/pipeline-runner.ts) (Pipeline runner), [`src/renderer/pages/ClipPage.tsx`](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/ClipPage.tsx) (Clip workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_app["App navigation<br/>[App.tsx]"]
  node_clip_ui["Clip workflow<br/>[ClipPage.tsx]"]
  node_jobs_ui["Jobs monitor<br/>[JobsPage.tsx]"]
  node_editor_ui["Clip editor<br/>[ClipEditor.tsx]"]
  node_library_ui["Library<br/>[LibraryPage.tsx]"]
  node_posts_ui["Posts and automation<br/>[PostsPage.tsx]"]
  node_preload["IPC bridge<br/>[index.ts]"]
end

subgraph group_orchestration["Job orchestration"]
  node_ipc["IPC handlers<br/>[ipc-handlers.ts]"]
  node_job_manager["Job manager<br/>[job-manager.ts]"]
  node_runner["Pipeline runner<br/>[pipeline-runner.ts]"]
  node_bridge["Python bridge<br/>[bridge_runner.py]"]
end

subgraph group_engine["Clipping engine"]
  node_ai_pipeline["AI clipping pipeline"]
  node_transcription["Transcription"]
  node_editorial["Editorial review"]
  node_jev["Jev reviews<br/>[jev_service.py]"]
  node_rendering["Video rendering"]
  node_config["Engine settings<br/>[config.py]"]
end

subgraph group_library["Library and publishing"]
  node_history[("Run history<br/>[run-history.ts]")]
  node_file_manager["Output files<br/>[file-manager.ts]"]
  node_zernio_service["Publishing service<br/>[service.ts]"]
end

subgraph group_integrations["External services"]
  node_zernio_client["Zernio API client<br/>[client.ts]"]
  node_openrouter["OpenRouter"]
  node_zernio["Zernio"]
end

node_user(("Video creator"))

node_user -->|"uses"| node_app
node_app -->|"opens"| node_clip_ui
node_app -->|"opens"| node_jobs_ui
node_app -->|"opens"| node_library_ui
node_app -->|"opens"| node_posts_ui
node_user -->|"submits video"| node_clip_ui
node_clip_ui -.->|"requests actions"| node_preload
node_preload -->|"invokes handlers"| node_ipc
node_ipc -.->|"dispatches jobs"| node_job_manager
node_job_manager -->|"starts pipeline"| node_runner
node_runner -->|"spawns bridge"| node_bridge
node_bridge -->|"runs pipeline"| node_ai_pipeline
node_ai_pipeline -->|"transcribes audio"| node_transcription
node_ai_pipeline -->|"reviews candidates"| node_editorial
node_ai_pipeline -->|"requests reviews"| node_jev
node_ai_pipeline -->|"renders clips"| node_rendering
node_transcription -->|"sends audio"| node_openrouter
node_jev -->|"requests judgments"| node_openrouter
node_user -->|"refines cuts"| node_editor_ui
node_user -->|"tracks progress"| node_jobs_ui
node_user -->|"finds exports"| node_library_ui
node_runner -.->|"records runs"| node_history
node_history -.->|"indexes outputs"| node_file_manager
node_posts_ui -.->|"manages publishing"| node_zernio_service
node_zernio_service -->|"uses client"| node_zernio_client
node_zernio_client -->|"calls API"| node_zernio
node_user -->|"publishes clips"| node_zernio_service

click node_app "https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/App.tsx"
click node_clip_ui "https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/ClipPage.tsx"
click node_jobs_ui "https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/JobsPage.tsx"
click node_editor_ui "https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/components/ClipEditor.tsx"
click node_library_ui "https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/LibraryPage.tsx"
click node_posts_ui "https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/PostsPage.tsx"
click node_preload "https://github.com/bridge-mind/bridgeclip/blob/main/src/preload/index.ts"
click node_ipc "https://github.com/bridge-mind/bridgeclip/blob/main/src/main/ipc-handlers.ts"
click node_job_manager "https://github.com/bridge-mind/bridgeclip/blob/main/src/main/job-manager.ts"
click node_runner "https://github.com/bridge-mind/bridgeclip/blob/main/src/main/pipeline-runner.ts"
click node_bridge "https://github.com/bridge-mind/bridgeclip/blob/main/bridge/bridge_runner.py"
click node_ai_pipeline "https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/ai_clipping_pipeline.py"
click node_transcription "https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/transcription_service.py"
click node_editorial "https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/coherence_review.py"
click node_jev "https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/jev_service.py"
click node_rendering "https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/rendering_service.py"
click node_config "https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/config.py"
click node_history "https://github.com/bridge-mind/bridgeclip/blob/main/src/main/run-history.ts"
click node_file_manager "https://github.com/bridge-mind/bridgeclip/blob/main/src/main/file-manager.ts"
click node_zernio_service "https://github.com/bridge-mind/bridgeclip/blob/main/src/main/zernio/service.ts"
click node_zernio_client "https://github.com/bridge-mind/bridgeclip/blob/main/src/main/zernio/client.ts"

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_app,node_clip_ui,node_jobs_ui,node_editor_ui,node_library_ui,node_posts_ui,node_preload toneBlue
class node_ipc,node_job_manager,node_runner,node_bridge toneAmber
class node_ai_pipeline,node_transcription,node_editorial,node_jev,node_rendering,node_config toneMint
class node_history,node_file_manager,node_zernio_service toneRose
class node_zernio_client,node_openrouter,node_zernio,node_user toneIndigo
```

## Components

### Desktop experience

- [App navigation](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/App.tsx): `src/renderer/App.tsx`
- [Clip workflow](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/ClipPage.tsx): `src/renderer/pages/ClipPage.tsx`
- [Jobs monitor](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/JobsPage.tsx): `src/renderer/pages/JobsPage.tsx`
- [Clip editor](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/components/ClipEditor.tsx): `src/renderer/components/ClipEditor.tsx`
- [Library](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/LibraryPage.tsx): `src/renderer/pages/LibraryPage.tsx`
- [Posts and automation](https://github.com/bridge-mind/bridgeclip/blob/main/src/renderer/pages/PostsPage.tsx): `src/renderer/pages/PostsPage.tsx`
- [IPC bridge](https://github.com/bridge-mind/bridgeclip/blob/main/src/preload/index.ts): `src/preload/index.ts`

### Job orchestration

- [IPC handlers](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/ipc-handlers.ts): `src/main/ipc-handlers.ts`
- [Job manager](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/job-manager.ts): `src/main/job-manager.ts`
- [Pipeline runner](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/pipeline-runner.ts): `src/main/pipeline-runner.ts`
- [Python bridge](https://github.com/bridge-mind/bridgeclip/blob/main/bridge/bridge_runner.py): `bridge/bridge_runner.py`

### Clipping engine

- [AI clipping pipeline](https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/ai_clipping_pipeline.py): `engine/clip_engine/services/ai_clipping_pipeline.py`
- [Transcription](https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/transcription_service.py): `engine/clip_engine/services/transcription_service.py`
- [Editorial review](https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/coherence_review.py): `engine/clip_engine/services/coherence_review.py`
- [Jev reviews](https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/jev_service.py): `engine/clip_engine/services/jev_service.py`
- [Video rendering](https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/services/rendering_service.py): `engine/clip_engine/services/rendering_service.py`
- [Engine settings](https://github.com/bridge-mind/bridgeclip/blob/main/engine/clip_engine/config.py): `engine/clip_engine/config.py`

### Library and publishing

- [Run history](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/run-history.ts): `src/main/run-history.ts`
- [Output files](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/file-manager.ts): `src/main/file-manager.ts`
- [Publishing service](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/zernio/service.ts): `src/main/zernio/service.ts`

### External services

- [Zernio API client](https://github.com/bridge-mind/bridgeclip/blob/main/src/main/zernio/client.ts): `src/main/zernio/client.ts`
- **OpenRouter**
- **Zernio**

### Other components

- **Video creator**

## Connections

- Video creator → App navigation: uses (evidence: `README.md`)
- App navigation → Clip workflow: opens (evidence: `src/renderer/App.tsx`)
- App navigation → Jobs monitor: opens (evidence: `src/renderer/App.tsx`)
- App navigation → Library: opens (evidence: `src/renderer/App.tsx`)
- App navigation → Posts and automation: opens (evidence: `src/renderer/App.tsx`)
- Video creator → Clip workflow: submits video (evidence: `README.md`)
- Clip workflow → IPC bridge: requests actions
- IPC bridge → IPC handlers: invokes handlers (evidence: `src/preload/index.ts`)
- IPC handlers → Job manager: dispatches jobs
- Job manager → Pipeline runner: starts pipeline (evidence: `src/main/job-manager.ts`)
- Pipeline runner → Python bridge: spawns bridge (evidence: `src/main/pipeline-runner.ts`)
- Python bridge → AI clipping pipeline: runs pipeline (evidence: `bridge/bridge_runner.py`)
- AI clipping pipeline → Transcription: transcribes audio (evidence: `engine/clip_engine/services/ai_clipping_pipeline.py`)
- AI clipping pipeline → Editorial review: reviews candidates (evidence: `engine/clip_engine/services/ai_clipping_pipeline.py`)
- AI clipping pipeline → Jev reviews: requests reviews (evidence: `engine/clip_engine/services/ai_clipping_pipeline.py`)
- AI clipping pipeline → Video rendering: renders clips (evidence: `engine/clip_engine/services/ai_clipping_pipeline.py`)
- Transcription → OpenRouter: sends audio (evidence: `README.md`)
- Jev reviews → OpenRouter: requests judgments (evidence: `engine/clip_engine/services/jev_service.py`)
- Video creator → Clip editor: refines cuts (evidence: `README.md`)
- Video creator → Jobs monitor: tracks progress (evidence: `README.md`)
- Video creator → Library: finds exports (evidence: `README.md`)
- Pipeline runner → Run history: records runs (evidence: `src/main/pipeline-runner.ts`)
- Run history → Output files: indexes outputs (evidence: `src/main/file-manager.ts`)
- Posts and automation → Publishing service: manages publishing
- Publishing service → Zernio API client: uses client (evidence: `src/main/zernio/service.ts`)
- Zernio API client → Zernio: calls API (evidence: `src/main/zernio/client.ts`)
- Video creator → Publishing service: publishes clips (evidence: `README.md`)
