How bridge-mind/bridgeclip works
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: App.tsx App navigation · ai_clipping_pipeline.py AI clipping pipeline · pipeline-runner.ts Pipeline runner · ClipPage.tsx Clip workflow
Components 24
Desktop experience
- App navigation
src/renderer/App.tsx - Clip workflow
src/renderer/pages/ClipPage.tsx - Jobs monitor
src/renderer/pages/JobsPage.tsx - Clip editor
src/renderer/components/ClipEditor.tsx - Library
src/renderer/pages/LibraryPage.tsx - Posts and automation
src/renderer/pages/PostsPage.tsx - IPC bridge
src/preload/index.ts
Job orchestration
- IPC handlers
src/main/ipc-handlers.ts - Job manager
src/main/job-manager.ts - Pipeline runner
src/main/pipeline-runner.ts - Python bridge
bridge/bridge_runner.py
Clipping engine
- AI clipping pipeline
engine/clip_engine/services/ai_clipping_pipeline.py - Transcription
engine/clip_engine/services/transcription_service.py - Editorial review
engine/clip_engine/services/coherence_review.py - Jev reviews
engine/clip_engine/services/jev_service.py - Video rendering
engine/clip_engine/services/rendering_service.py - Engine settings
engine/clip_engine/config.py
Library and publishing
- Run history
src/main/run-history.ts - Output files
src/main/file-manager.ts - Publishing service
src/main/zernio/service.ts
External services
- Zernio API client
src/main/zernio/client.ts - OpenRouter
- Zernio
Other components
- Video creator
Connections 27
- Video creator → App navigation: uses
README.md - App navigation → Clip workflow: opens
src/renderer/App.tsx - App navigation → Jobs monitor: opens
src/renderer/App.tsx - App navigation → Library: opens
src/renderer/App.tsx - App navigation → Posts and automation: opens
src/renderer/App.tsx - Video creator → Clip workflow: submits video
README.md - Clip workflow → IPC bridge: requests actions
- IPC bridge → IPC handlers: invokes handlers
src/preload/index.ts - IPC handlers → Job manager: dispatches jobs
- Job manager → Pipeline runner: starts pipeline
src/main/job-manager.ts - Pipeline runner → Python bridge: spawns bridge
src/main/pipeline-runner.ts - Python bridge → AI clipping pipeline: runs pipeline
bridge/bridge_runner.py - AI clipping pipeline → Transcription: transcribes audio
engine/clip_engine/services/ai_clipping_pipeline.py - AI clipping pipeline → Editorial review: reviews candidates
engine/clip_engine/services/ai_clipping_pipeline.py - AI clipping pipeline → Jev reviews: requests reviews
engine/clip_engine/services/ai_clipping_pipeline.py - AI clipping pipeline → Video rendering: renders clips
engine/clip_engine/services/ai_clipping_pipeline.py - Transcription → OpenRouter: sends audio
README.md - Jev reviews → OpenRouter: requests judgments
engine/clip_engine/services/jev_service.py - Video creator → Clip editor: refines cuts
README.md - Video creator → Jobs monitor: tracks progress
README.md - Video creator → Library: finds exports
README.md - Pipeline runner → Run history: records runs
src/main/pipeline-runner.ts - Run history → Output files: indexes outputs
src/main/file-manager.ts - Posts and automation → Publishing service: manages publishing
- Publishing service → Zernio API client: uses client
src/main/zernio/service.ts - Zernio API client → Zernio: calls API
src/main/zernio/client.ts - Video creator → Publishing service: publishes clips
README.md