How gnaro-shaft/tiktok-generator-video works
This repository generates short-form TikTok videos across six configured niches. The main workflow starts from a CLI request, loads niche settings and prompts, generates a script, then synthesizes narration and finds stock footage before rendering a Remotion overlay and composing the final video; optional music mixing and run-history tracking support that process. Separate core modules provide TikTok authorization, publishing, and analytics. README and sampled pipeline code establish the generation stages; unsampled TikTok modules are retained as capabilities, but their runtime wiring to the CLI is not asserted.
Main entry points: pipeline.ts Generation pipeline · main.ts Generation CLI · render.ts Overlay rendering · compose.ts Video composition
Components 23
Entry & Configuration
- Generation CLI
apps/cli/src/main.ts - Niche settings
niches - Config loader
packages/core/src/lib/config.ts
Content Generation
- Generation pipeline
packages/core/src/lib/pipeline.ts - Script generation
packages/core/src/lib/script.ts - Voice synthesis
packages/core/src/lib/voice.ts - Stock footage
packages/core/src/lib/stock.ts - Run history
packages/core/src/lib/state.ts
Video Production
- Music mixing
packages/core/src/lib/music.ts - Overlay rendering
packages/core/src/lib/render.ts - Remotion compositions
packages/remotion/src/TikTokVideo.tsx - Slides composition
packages/remotion/src/SlidesVideo.tsx - Video composition
packages/core/src/lib/compose.ts
TikTok Integration
- TikTok OAuth
packages/core/src/lib/tiktok-auth.ts - TikTok publishing
packages/core/src/lib/tiktok-publish.ts - TikTok analytics
packages/core/src/lib/tiktok-analytics.ts
Other components
- CLI user
- Anthropic API
- ElevenLabs API
- Pexels / Pixabay
- ffmpeg
- Video & sidecars
- TikTok API
Connections 24
- CLI user → Generation CLI: requests generation
README.md - Generation CLI → Config loader: loads settings
apps/cli/src/main.ts - Config loader → Niche settings: loads niche
packages/core/src/lib/config.ts - Generation CLI → Generation pipeline: starts run
apps/cli/src/main.ts - Generation pipeline → Script generation: generates script
packages/core/src/lib/pipeline.ts - Script generation → Anthropic API: requests completion
packages/core/src/lib/script.ts - Generation pipeline → Voice synthesis: synthesizes narration
packages/core/src/lib/pipeline.ts - Voice synthesis → ElevenLabs API: requests speech
packages/core/src/lib/voice.ts - Generation pipeline → Stock footage: searches footage
packages/core/src/lib/pipeline.ts - Stock footage → Pexels / Pixabay: searches providers
packages/core/src/lib/stock.ts - Generation pipeline → Music mixing: mixes audio
packages/core/src/lib/pipeline.ts - Generation pipeline → Overlay rendering: renders overlay
packages/core/src/lib/pipeline.ts - Overlay rendering → Remotion compositions: renders composition
README.md - Overlay rendering → Slides composition: renders slides
README.md - Generation pipeline → Video composition: composes video
README.md - Video composition → ffmpeg: runs composition
packages/core/src/lib/compose.ts - Generation pipeline → Run history: records run
packages/core/src/lib/pipeline.ts - Video composition → Video & sidecars: writes video
README.md - Generation pipeline → Video & sidecars: writes sidecars
README.md - TikTok publishing → TikTok OAuth: uses authorization
packages/core/src/lib/tiktok-publish.ts - TikTok analytics → TikTok OAuth: uses authorization
packages/core/src/lib/tiktok-analytics.ts - TikTok OAuth → TikTok API: exchanges tokens
packages/core/src/lib/tiktok-auth.ts - TikTok publishing → TikTok API: publishes videos
- TikTok analytics → TikTok API: fetches metrics