How dingshuxin353/live-clipper works
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: project_service.py Project service · project-api.ts Web API client · App.tsx Workbench routes · project_result_api.py Result and recovery API
Components 26
Desktop runtime
- Electron shell
desktop/main.js - Backend client
desktop/backend-client.js
Workbench UI
- Workbench routes
frontend/src/App.tsx - Setup and migration
frontend/src/Onboarding.tsx - Studio projects
frontend/src/StudioProjects.tsx - Project workflows
frontend/src/ProjectDialogs.tsx - Project detail
frontend/src/ProjectDetail.tsx - Clip results
frontend/src/RunResultPage.tsx - Resource management
frontend/src/ResourcesPage.tsx - Web API client
frontend/src/project-api.ts - Domain data contracts
frontend/src/project-dto.ts
Project operations
- Local Python service
src/live_clipper/service.py - Project service
src/live_clipper/project_service.py - Project domain
src/live_clipper/project_domain.py - Project history store
src/live_clipper/project_storage.py - Recording discovery
src/live_clipper/project_scan.py - Scheduled scans
src/live_clipper/project_scheduler.py
Clip processing
- Transcribe and analyze
src/live_clipper/pipeline.py - AI review
src/live_clipper/review_automation.py - Clip rendering
src/live_clipper/render_clips.py
Results and recovery
- Result and recovery API
src/live_clipper/project_result_api.py - Result runtime
src/live_clipper/project_result_runtime.py - Reprocessing
src/live_clipper/project_reprocess.py
Models and resources
- Project resources
src/live_clipper/project_resources.py - Resource registry
src/live_clipper/resource_store.py
Other components
- Creator
Connections 34
- Creator → Electron shell: opens
README.md - Electron shell → Backend client: requests
desktop/main.js - Backend client → Local Python service: calls local API
desktop/backend-client.js - Creator → Workbench routes: uses
README.md - Workbench routes → Setup and migration: routes to
frontend/src/App.tsx - Workbench routes → Studio projects: routes to
frontend/src/App.tsx - Workbench routes → Resource management: routes to
frontend/src/App.tsx - Workbench routes → Project workflows: opens dialogs
frontend/src/App.tsx - Web API client → Domain data contracts: uses types
frontend/src/project-api.ts - Web API client → Workbench routes: serves requests
frontend/src/App.tsx - Studio projects → Web API client: loads projects
- Project workflows → Web API client: submits project actions
frontend/src/ProjectDialogs.tsx - Project detail → Web API client: loads project data
- Clip results → Web API client: loads results
frontend/src/RunResultPage.tsx - Resource management → Web API client: manages resources
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
src/live_clipper/project_service.py - Project service → Project history store: persists project state
src/live_clipper/project_service.py - Project service → Recording discovery: starts scans
- Scheduled scans → Recording discovery: runs scheduled scans
src/live_clipper/project_scheduler.py - Project service → Scheduled scans: coordinates schedules
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
src/live_clipper/project_service.py - Project resources → Resource registry: reads and writes
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
README.md