How xixihhhh/hotclip works
HotClip is a local-first desktop and headless tool for turning long videos, livestreams, and audio into reviewed vertical short clips. The main workflow imports media, transcribes or imports subtitles, gathers evidence for AI highlight selection, lets users review candidates, then renders and packages selected clips for publishing. The graph includes documented project persistence and unattended recording workflows. Source excerpts confirm the shared pipeline’s transcription, evidence collection, and export calls; several other capabilities are represented from the README and tree, with uncertain internal wiring omitted.
Main entry points: pipeline.ts Shared Pipeline · index.ts Electron Main · App.tsx Desktop UI · export.ts Clip Export
Components 22
User Interfaces
- Desktop UI
src/renderer/src/App.tsx - Typed IPC
src/preload/index.ts - Electron Main
src/main/index.ts - Headless CLI
src/cli/index.ts - MCP Server
src/mcp/server.ts
Clip Workflow
- Media Import
src/core/url-import.ts - Shared Pipeline
src/core/pipeline.ts - Speech Engines
src/core/transcribe/types.ts - Subtitle Import
src/core/subtitle-import.ts - Media Evidence
src/core/media-evidence.ts - Highlight Detection
src/core/highlight/detect.ts - Candidate Review
src/renderer/src/components/ClipReviewModal.tsx
Creation and Publishing
- Clip Export
src/core/export.ts - Vertical Reframe
src/core/reframe/index.ts - Publish Packages
src/core/publish-pack.ts
Projects and Automation
- Project Workspace
src/core/project-workspace.ts - Recording Watch
src/core/watch.ts - Recorder Webhook
src/core/webhook.ts
External Interfaces
- Recorder Apps
- LLM Service
- Local Media
Other components
- Creator
Connections 23
- Creator → Desktop UI: selects media
- Desktop UI → Typed IPC: invokes API
- Typed IPC → Electron Main: sends IPC
- Electron Main → Media Import: imports URL
- Electron Main → Shared Pipeline: requests analysis
- Headless CLI → Shared Pipeline: runs workflow
- MCP Server → Shared Pipeline: runs workflow
- Local Media → Shared Pipeline: provides media
- Shared Pipeline → Speech Engines: transcribes media
- Shared Pipeline → Subtitle Import: imports subtitles
- Shared Pipeline → Media Evidence: collects signals
- Shared Pipeline → Highlight Detection: detects clips
- Shared Pipeline → Clip Export: exports selected clips
- Desktop UI → Candidate Review: reviews candidates
- Candidate Review → Typed IPC: requests preview data
- Electron Main → Project Workspace: saves projects
- Recorder Apps → Recording Watch: writes recordings
- Recorder Apps → Recorder Webhook: sends completion
- Recording Watch → Shared Pipeline: starts clipping
- Recorder Webhook → Shared Pipeline: starts clipping
- Clip Export → Vertical Reframe: renders vertical
- Clip Export → Publish Packages: prepares packages
- Shared Pipeline → LLM Service: requests selection