How arielletolome/overlay-text-video-editor works
This repository is an AI-assisted vertical-video production engine. Users invoke the CLI to render batches of caption/style overlays onto raw clips, or to build a UGC ad from hook, proof/demo, and CTA footage; outputs can be graded, animated, mixed, evaluated, organized, and packaged. The README documents additional caption styles, placement/timing options, music extraction, AI scoring, and persistent session memory. Those capabilities are represented where paths or sampled call wiring support them; unsampled subsystems use their existing source directory or are omitted where wiring is unclear.
Main entry points: stitcher.ts UGC stitcher · cli.ts CLI options · editor.ts Batch editor · ai.ts AI script and score
Components 18
User workflow
- CLI options
src/cli.ts - Batch editor
src/editor.ts
Caption rendering
- Overlay renderer
src/renderer.ts - Style templates
templates
UGC production
- UGC stitcher
src/stitcher.ts - AI script and score
src/ai.ts - Reaction hooks
src/types.ts
Media finishing
- Color grading
src/grade.ts - Video animation
src/animation.ts - Audio processing
src/audio.ts - Video evaluation
src/evaluator.ts
Output and memory
- Media utilities
src/utils.ts - Session memory
src/session.ts - Rendered deliverables
Other components
- Video editor
- CLIProxyAPI
- Fish Audio service
- TikTok / YouTube audio
Connections 21
- Video editor → CLI options: sets options
- CLI options → Batch editor: runs batch
- Batch editor → Overlay renderer: renders overlays
- Overlay renderer → Style templates: loads styles
- Batch editor → Media utilities: composites and packages
- Batch editor → Rendered deliverables: writes batch
- CLI options → UGC stitcher: runs stitch mode
- CLI options → AI script and score: requests virality score
- UGC stitcher → AI script and score: generates script
- AI script and score → CLIProxyAPI: calls API
- AI script and score → Reaction hooks: gets hook text
- UGC stitcher → Reaction hooks: selects hook presets
- UGC stitcher → Color grading: grades footage
- UGC stitcher → Video animation: applies effects
- UGC stitcher → Audio processing: mixes audio
- UGC stitcher → Video evaluation: evaluates output
- UGC stitcher → Fish Audio service: requests speech
- UGC stitcher → TikTok / YouTube audio: downloads music
- UGC stitcher → Rendered deliverables: writes stitched video
- CLI options → Session memory: reads or shows memory
- CLI options → Rendered deliverables: records run