How hassancs91/claude-faceless-shorts-creator works
This repository is a Claude-driven production system for faceless YouTube Shorts, with TSX/Remotion, generative-video, and documentary-collage tracks. The documented workflow turns a topic into a visual composition, checks frames, generates word-timed narration, and mixes sound into a finished video. The available tree primarily exposes the Remotion project and media-generation tools; Claude skills, project assets, and much of the production orchestration are not present, so those connections are represented only where the README documents them.
Main entry points: shots TSX shorts · vox-1 Vox collage · registry.gen.tsx Shot registry · ai-1 Generative short
Components 19
Visual tracks
- TSX shorts
remotion/src/shots - Generative short
remotion/src/shots/ai-1 - Vox collage
remotion/src/shots/vox-1
Remotion runtime
- Shot registry
remotion/src/registry.gen.tsx - Shorts kit
remotion/src/lib/shorts.tsx - Visual kits
remotion/src/lib - Collage engine
remotion/src/lib/collage.tsx - World geometry
remotion/src/lib/geo/world.ts - Fonts and brand
remotion/src/fonts.ts
Media production
- Frame QA
tools/capture_web.py - Voice and captions
tools/gen_voice.py - Sound effects
tools/gen_sfx.py - Music beds
tools/gen_music.py - Audio mixing
tools/mix_sfx.py - Image layers
tools/gen_image.py - Cutouts
tools/cutout.py - Video clips
tools/gen_clip.py - Finished short
Other components
- Creator / Claude
Connections 27
- Creator / Claude → TSX shorts: requests composition
README.md - Creator / Claude → Generative short: requests video
README.md - Creator / Claude → Vox collage: requests story
README.md - Shot registry → TSX shorts: registers shots
remotion/src/registry.gen.tsx - Shot registry → Generative short: registers shot
remotion/src/registry.gen.tsx - Shot registry → Vox collage: registers shot
remotion/src/registry.gen.tsx - TSX shorts → Shorts kit: uses shared kit
remotion/src/shots/short-1/Short1Chess.tsx - TSX shorts → Visual kits: uses visuals
remotion/src/shots/short-11/Short11Map.tsx - TSX shorts → Collage engine: uses collage engine
remotion/src/shots/vox-1/Vox1Coffee.tsx - Visual kits → World geometry: projects geography
remotion/src/lib/map.tsx - Shorts kit → Fonts and brand: uses fonts
remotion/src/lib/shorts.tsx - Collage engine → Fonts and brand: uses fonts
remotion/src/lib/collage.tsx - Creator / Claude → Frame QA: reviews frames
README.md - Creator / Claude → Voice and captions: generates narration
README.md - Creator / Claude → Sound effects: produces sound
README.md - Creator / Claude → Music beds: produces music
README.md - Creator / Claude → Image layers: produces layers
README.md - Creator / Claude → Cutouts: cuts out layers
README.md - Creator / Claude → Video clips: generates clips
README.md - Creator / Claude → Audio mixing: mixes effects
README.md - TSX shorts → Frame QA: renders for review
README.md - Generative short → Video clips: uses generated clips
README.md - Vox collage → Image layers: uses generated layers
README.md - Vox collage → Cutouts: uses die-cuts
README.md - Voice and captions → Finished short: supplies narration
README.md - Audio mixing → Finished short: mixes final audio
README.md - Music beds → Audio mixing: optional music bed
README.md