# dingshuxin353/live-clipper architecture

> Architecture diagram of the GitHub repository dingshuxin353/live-clipper, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dingshuxin353/live-clipper
- Repository: https://github.com/dingshuxin353/live-clipper

## Overview

Venus is a macOS live-stream editing workbench: users set up or migrate, manage projects and recording sources, scan manually or on a schedule, then review rendered clips and recover or reprocess runs. The Electron shell communicates with a local Python service; the web workbench calls its API. The README documents the end-to-end processing and local-file boundaries. Several backend and page modules are indexed but unsampled, so their subsystem links are limited to documented flows and indexed references.

Main entry points: [`src/live_clipper/project_service.py`](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_service.py) (Project service), [`frontend/src/project-api.ts`](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/project-api.ts) (Web API client), [`frontend/src/App.tsx`](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/App.tsx) (Workbench routes), [`src/live_clipper/project_result_api.py`](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_result_api.py) (Result and recovery API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop runtime"]
  node_electron["Electron shell<br/>[main.js]"]
  node_desktop_client["Backend client<br/>[backend-client.js]"]
end

subgraph group_workbench["Workbench UI"]
  node_workbench_app["Workbench routes<br/>[App.tsx]"]
  node_onboarding["Setup and migration<br/>[Onboarding.tsx]"]
  node_studio["Studio projects<br/>[StudioProjects.tsx]"]
  node_project_pages["Project workflows<br/>[ProjectDialogs.tsx]"]
  node_project_detail["Project detail<br/>[ProjectDetail.tsx]"]
  node_results_ui["Clip results<br/>[RunResultPage.tsx]"]
  node_resource_ui["Resource management<br/>[ResourcesPage.tsx]"]
  node_api_client["Web API client<br/>[project-api.ts]"]
  node_dto["Domain data contracts<br/>[project-dto.ts]"]
end

subgraph group_projects["Project operations"]
  node_py_service["Local Python service<br/>[service.py]"]
  node_project_service["Project service<br/>[project_service.py]"]
  node_project_domain["Project domain<br/>[project_domain.py]"]
  node_project_store[("Project history store<br/>[project_storage.py]")]
  node_scanner["Recording discovery<br/>[project_scan.py]"]
  node_scheduler["Scheduled scans"]
end

subgraph group_processing["Clip processing"]
  node_pipeline["Transcribe and analyze<br/>[pipeline.py]"]
  node_review["AI review"]
  node_renderer["Clip rendering<br/>[render_clips.py]"]
end

subgraph group_results["Results and recovery"]
  node_result_api["Result and recovery API"]
  node_result_runtime["Result runtime"]
  node_reprocess["Reprocessing"]
end

subgraph group_resources["Models and resources"]
  node_resource_service["Project resources"]
  node_resource_store[("Resource registry<br/>[resource_store.py]")]
end

node_user(("Creator"))

node_user -->|"opens"| node_electron
node_electron -->|"requests"| node_desktop_client
node_desktop_client -->|"calls local API"| node_py_service
node_user -->|"uses"| node_workbench_app
node_workbench_app -->|"routes to"| node_onboarding
node_workbench_app -->|"routes to"| node_studio
node_workbench_app -->|"routes to"| node_resource_ui
node_workbench_app -->|"opens dialogs"| node_project_pages
node_api_client -->|"uses types"| node_dto
node_api_client -.->|"serves requests"| node_workbench_app
node_studio -->|"loads projects"| node_api_client
node_project_pages -->|"submits project actions"| node_api_client
node_project_detail -.->|"loads project data"| node_api_client
node_results_ui -->|"loads results"| node_api_client
node_resource_ui -->|"manages resources"| node_api_client
node_api_client -.->|"calls service API"| node_py_service
node_py_service -.->|"dispatches operations"| node_project_service
node_project_service -->|"uses"| node_project_domain
node_project_service -->|"persists project state"| node_project_store
node_project_service -.->|"starts scans"| node_scanner
node_scheduler -->|"runs scheduled scans"| node_scanner
node_project_service -->|"coordinates schedules"| node_scheduler
node_user -.->|"creates and scans projects"| node_project_service
node_scanner -.->|"queues recordings"| node_pipeline
node_pipeline -.->|"prepares review"| node_review
node_review -.->|"selects clips"| node_renderer
node_project_service -.->|"runs processing"| node_pipeline
node_project_service -->|"resolves project resources"| node_resource_service
node_resource_service -->|"reads and writes"| node_resource_store
node_results_ui -.->|"views and recovers runs"| node_result_api
node_result_api -.->|"delegates result operations"| node_result_runtime
node_result_api -.->|"requests reprocessing"| node_reprocess
node_reprocess -.->|"records run history"| node_project_store
node_user -->|"reviews clips"| node_results_ui

click node_electron "https://github.com/dingshuxin353/live-clipper/blob/master/desktop/main.js"
click node_desktop_client "https://github.com/dingshuxin353/live-clipper/blob/master/desktop/backend-client.js"
click node_py_service "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/service.py"
click node_workbench_app "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/App.tsx"
click node_onboarding "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/Onboarding.tsx"
click node_studio "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/StudioProjects.tsx"
click node_project_pages "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/ProjectDialogs.tsx"
click node_project_detail "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/ProjectDetail.tsx"
click node_results_ui "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/RunResultPage.tsx"
click node_resource_ui "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/ResourcesPage.tsx"
click node_api_client "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/project-api.ts"
click node_dto "https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/project-dto.ts"
click node_project_service "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_service.py"
click node_project_domain "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_domain.py"
click node_project_store "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_storage.py"
click node_scanner "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_scan.py"
click node_scheduler "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_scheduler.py"
click node_pipeline "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/pipeline.py"
click node_review "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/review_automation.py"
click node_renderer "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/render_clips.py"
click node_resource_service "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_resources.py"
click node_resource_store "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/resource_store.py"
click node_result_api "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_result_api.py"
click node_result_runtime "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_result_runtime.py"
click node_reprocess "https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_reprocess.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_electron,node_desktop_client toneBlue
class node_workbench_app,node_onboarding,node_studio,node_project_pages,node_project_detail,node_results_ui,node_resource_ui,node_api_client,node_dto toneAmber
class node_py_service,node_project_service,node_project_domain,node_project_store,node_scanner,node_scheduler toneMint
class node_pipeline,node_review,node_renderer toneRose
class node_result_api,node_result_runtime,node_reprocess,node_user toneIndigo
class node_resource_service,node_resource_store toneTeal
```

## Components

### Desktop runtime

- [Electron shell](https://github.com/dingshuxin353/live-clipper/blob/master/desktop/main.js): `desktop/main.js`
- [Backend client](https://github.com/dingshuxin353/live-clipper/blob/master/desktop/backend-client.js): `desktop/backend-client.js`

### Workbench UI

- [Workbench routes](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Setup and migration](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/Onboarding.tsx): `frontend/src/Onboarding.tsx`
- [Studio projects](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/StudioProjects.tsx): `frontend/src/StudioProjects.tsx`
- [Project workflows](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/ProjectDialogs.tsx): `frontend/src/ProjectDialogs.tsx`
- [Project detail](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/ProjectDetail.tsx): `frontend/src/ProjectDetail.tsx`
- [Clip results](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/RunResultPage.tsx): `frontend/src/RunResultPage.tsx`
- [Resource management](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/ResourcesPage.tsx): `frontend/src/ResourcesPage.tsx`
- [Web API client](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/project-api.ts): `frontend/src/project-api.ts`
- [Domain data contracts](https://github.com/dingshuxin353/live-clipper/blob/master/frontend/src/project-dto.ts): `frontend/src/project-dto.ts`

### Project operations

- [Local Python service](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/service.py): `src/live_clipper/service.py`
- [Project service](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_service.py): `src/live_clipper/project_service.py`
- [Project domain](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_domain.py): `src/live_clipper/project_domain.py`
- [Project history store](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_storage.py): `src/live_clipper/project_storage.py`
- [Recording discovery](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_scan.py): `src/live_clipper/project_scan.py`
- [Scheduled scans](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_scheduler.py): `src/live_clipper/project_scheduler.py`

### Clip processing

- [Transcribe and analyze](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/pipeline.py): `src/live_clipper/pipeline.py`
- [AI review](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/review_automation.py): `src/live_clipper/review_automation.py`
- [Clip rendering](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/render_clips.py): `src/live_clipper/render_clips.py`

### Results and recovery

- [Result and recovery API](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_result_api.py): `src/live_clipper/project_result_api.py`
- [Result runtime](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_result_runtime.py): `src/live_clipper/project_result_runtime.py`
- [Reprocessing](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_reprocess.py): `src/live_clipper/project_reprocess.py`

### Models and resources

- [Project resources](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/project_resources.py): `src/live_clipper/project_resources.py`
- [Resource registry](https://github.com/dingshuxin353/live-clipper/blob/master/src/live_clipper/resource_store.py): `src/live_clipper/resource_store.py`

### Other components

- **Creator**

## Connections

- Creator → Electron shell: opens (evidence: `README.md`)
- Electron shell → Backend client: requests (evidence: `desktop/main.js`)
- Backend client → Local Python service: calls local API (evidence: `desktop/backend-client.js`)
- Creator → Workbench routes: uses (evidence: `README.md`)
- Workbench routes → Setup and migration: routes to (evidence: `frontend/src/App.tsx`)
- Workbench routes → Studio projects: routes to (evidence: `frontend/src/App.tsx`)
- Workbench routes → Resource management: routes to (evidence: `frontend/src/App.tsx`)
- Workbench routes → Project workflows: opens dialogs (evidence: `frontend/src/App.tsx`)
- Web API client → Domain data contracts: uses types (evidence: `frontend/src/project-api.ts`)
- Web API client → Workbench routes: serves requests (evidence: `frontend/src/App.tsx`)
- Studio projects → Web API client: loads projects
- Project workflows → Web API client: submits project actions (evidence: `frontend/src/ProjectDialogs.tsx`)
- Project detail → Web API client: loads project data
- Clip results → Web API client: loads results (evidence: `frontend/src/RunResultPage.tsx`)
- Resource management → Web API client: manages resources (evidence: `frontend/src/ResourcesPage.tsx`)
- Web API client → Local Python service: calls service API
- Local Python service → Project service: dispatches operations
- Project service → Project domain: uses (evidence: `src/live_clipper/project_service.py`)
- Project service → Project history store: persists project state (evidence: `src/live_clipper/project_service.py`)
- Project service → Recording discovery: starts scans
- Scheduled scans → Recording discovery: runs scheduled scans (evidence: `src/live_clipper/project_scheduler.py`)
- Project service → Scheduled scans: coordinates schedules (evidence: `src/live_clipper/project_service.py`)
- Creator → Project service: creates and scans projects
- Recording discovery → Transcribe and analyze: queues recordings
- Transcribe and analyze → AI review: prepares review
- AI review → Clip rendering: selects clips
- Project service → Transcribe and analyze: runs processing
- Project service → Project resources: resolves project resources (evidence: `src/live_clipper/project_service.py`)
- Project resources → Resource registry: reads and writes (evidence: `src/live_clipper/project_resources.py`)
- Clip results → Result and recovery API: views and recovers runs
- Result and recovery API → Result runtime: delegates result operations
- Result and recovery API → Reprocessing: requests reprocessing
- Reprocessing → Project history store: records run history
- Creator → Clip results: reviews clips (evidence: `README.md`)
