How allthingsaman/clipkaro works
ClipKaro turns a local video or YouTube source into vertical, captioned short videos, with a live-stream mode that can post clips while a stream is running. The standard workflow fetches and transcribes media, prepares transcript parts and candidate moments, reviews and cuts selected clips, then edits and checks the results. Separate capabilities include deep clips, speech and visual cues, speaker-aware framing, and rendering. The README documents the main stages; some branches are represented by their source modules, but their internal calls were not sampled, so unsupported links are omitted.
Main entry points: cut.py Clip cutting · parts.py Transcript parts · edit.py Clip editing · fetch.py Fetch and transcribe
Components 25
Media intake
- Command workflow
run.py - Fetch and transcribe
clipper/fetch.py - Live clipping
clipper/live.py - Stream reaction hints
clipper/twitch.py
Clip discovery
- Transcript parts
clipper/parts.py - Topics and candidates
clipper/topics.py - Blind clip review
clipper/critic.py - Deep clips
clipper/deep.py
Clip production
- Clip cutting
clipper/cut.py - Clip editing
clipper/edit.py - Quality checks
clipper/qa.py - Shared media utilities
clipper/common.py
Analysis and framing
- Video type and breaks
clipper/kind.py - Sound cues
clipper/sound.py - Speech and action hints
clipper/hints.py - Speaker analysis
clipper/speakers.py - Voice identity
clipper/voices.py - Speaker-aware reframing
clipper/reframe.py - Facecam detection
clipper/facecam.py - Motion cues
clipper/motion.py
Rendering and delivery
- Edit plan
clipper/plan.py - Remotion renderer
remotion/src/Clip.tsx - Social posting
clipper/post.py
Other components
- Video creator
- Posting platforms
Connections 35
- Video creator → Command workflow: requests clips
- Command workflow → Fetch and transcribe: starts intake
- Fetch and transcribe → Transcript parts: transcript for
- Transcript parts → Topics and candidates: parts read
clipper/topics.py - Topics and candidates → Blind clip review: candidate ideas
clipper/critic.py - Blind clip review → Clip cutting: selected clips
clipper/critic.py - Clip cutting → Clip editing: cut footage
clipper/edit.py - Clip editing → Quality checks: edited clips
- Command workflow → Live clipping: starts live mode
- Live clipping → Stream reaction hints: adds reaction hints
- Live clipping → Quality checks: checks clips
- Quality checks → Social posting: approved clips
- Social posting → Posting platforms: posts clips
- Transcript parts → Deep clips: supports deep clips
clipper/deep.py - Fetch and transcribe → Video type and breaks: detects video type
clipper/fetch.py - Video type and breaks → Facecam detection: detects facecam
clipper/kind.py - Video type and breaks → Fetch and transcribe: reads metadata
clipper/kind.py - Transcript parts → Speech and action hints: uses transcript hints
clipper/parts.py - Speech and action hints → Sound cues: loads sound cues
clipper/hints.py - Speech and action hints → Voice identity: gets other voices
clipper/hints.py - Speech and action hints → Motion cues: combines motion cues
clipper/hints.py - Clip cutting → Fetch and transcribe: gets source video
clipper/cut.py - Clip cutting → Speaker-aware reframing: frames shots
clipper/cut.py - Clip cutting → Speaker analysis: uses speaker signals
clipper/cut.py - Clip cutting → Video type and breaks: applies video rules
clipper/cut.py - Clip cutting → Sound cues: uses sound cues
clipper/cut.py - Clip editing → Edit plan: builds edit plan
clipper/edit.py - Clip editing → Speaker-aware reframing: uses framing data
clipper/edit.py - Edit plan → Remotion renderer: shared render plan
clipper/plan.py - Transcript parts → Sound cues: loads sound cues
clipper/parts.py - Transcript parts → Video type and breaks: filters break spans
clipper/parts.py - Speaker analysis → Speaker-aware reframing: speaker framing signals
clipper/speakers.py - Voice identity → Speaker analysis: uses voice analysis
clipper/voices.py - Speaker-aware reframing → Shared media utilities: uses media helpers
clipper/reframe.py - Clip editing → Shared media utilities: uses shared helpers
clipper/edit.py