How lcy362/free-short-video-studio works
FreeShortVideoStudio is a browser-based AI short-video maker. Users configure an idea, generate and edit scenes, request per-scene videos, then stitch and download the result locally. The README also describes project recovery, model selection, multiple Agnes domains, and language support. Source excerpts show the main client-to-rendering, orchestration, API, persistence, and FFmpeg paths; some UI wiring and the scene-splitting call are not shown, so those links are marked unverified.
Main entry points: StudioClient.tsx Studio client · orchestrator.ts Generation orchestrator · video-api.ts Video API client · page.tsx Localized page
Components 23
Studio entry
- Localized page
app/page.tsx - Studio landing
components/StudioLanding.tsx - Studio client
studio-core/StudioClient.tsx
Scene creation
- Idea and options
studio-core/components/IdeaInput.tsx - Scene splitting
studio-core/lib/chat-api.ts - Prompt templates
studio-core/lib/prompt-templates.ts - Scene editing
studio-core/components/SceneList.tsx
Video generation
- Generation orchestrator
studio-core/lib/orchestrator.ts - Video API client
studio-core/lib/video-api.ts - Agnes AI API
- Domain failover
studio-core/lib/api-domains.ts - Video model config
studio-core/lib/video-models.ts - Submit rate limiter
studio-core/lib/rate-limiter.ts
Local rendering
- FFmpeg loading UI
studio-core/components/FFmpegLoader.tsx - FFmpeg service
studio-core/lib/ffmpeg-service.ts - Video preview and download
studio-core/components/VideoPreview.tsx - Video download proxy
functions/api/video-download/[[path]].ts
State and settings
- API key panel
studio-core/ApiKeyPanel.tsx - Project persistence
studio-core/lib/task-store.ts - Task list
studio-core/components/TaskList.tsx - Studio logger
studio-core/lib/logger.ts - Log panel
studio-core/components/LogPanel.tsx
Other components
- Studio user
Connections 23
- Studio user → Localized page: opens
README.md - Localized page → Studio landing: renders
app/page.tsx - Studio landing → Studio client: renders
components/StudioLanding.tsx - Studio client → Generation orchestrator: creates
studio-core/StudioClient.tsx - Generation orchestrator → Video API client: submits and polls
studio-core/lib/orchestrator.ts - Video API client → Agnes AI API: requests videos
studio-core/lib/video-api.ts - Video API client → Domain failover: uses failover
studio-core/lib/video-api.ts - Generation orchestrator → Submit rate limiter: waits between submits
studio-core/lib/orchestrator.ts - Generation orchestrator → Studio logger: records progress
studio-core/lib/orchestrator.ts - Studio client → Project persistence: loads and saves projects
studio-core/StudioClient.tsx - Task list → Project persistence: reads tasks
studio-core/components/TaskList.tsx - Log panel → Studio logger: reads logs
studio-core/components/LogPanel.tsx - Studio client → FFmpeg service: loads and processes clips
studio-core/StudioClient.tsx - Studio client → FFmpeg loading UI: renders during processing
studio-core/StudioClient.tsx - Studio client → Video preview and download: renders completed video
studio-core/StudioClient.tsx - Video API client → Video download proxy: downloads via proxy
studio-core/lib/video-api.ts - Studio client → API key panel: uses key panel
studio-core/StudioClient.tsx - Studio client → Idea and options: collects settings
studio-core/StudioClient.tsx - Studio client → Scene splitting: requests scene split
studio-core/StudioClient.tsx - Scene splitting → Prompt templates: uses templates
studio-core/lib/chat-api.ts - Studio client → Scene editing: edits scene list
studio-core/StudioClient.tsx - Studio client → Video model config: loads model choice
studio-core/StudioClient.tsx - FFmpeg service → Agnes AI API: loads engine from CDN
studio-core/lib/ffmpeg-service.ts