How thisispen/openshorts works
OpenShorts turns long-form video into short-form social content, with a dashboard and self-hosted/cloud operation. The main workflow is video submission, AI moment selection, reframing and editing, then captioned clip output; separate product branches cover AI UGC creation, YouTube Studio, publishing, and the public gallery. The README documents those capabilities, but sampled backend excerpts do not expose every route or subsystem connection, so some links are intentionally omitted or marked unverified.
Main entry points: App.jsx Dashboard app · main.py Clip pipeline · database.py Cloud database · auth.py Cloud authentication
Components 25
User experience
- Dashboard app
dashboard/src/App.jsx - Sign-in and account
dashboard/src/contexts/AuthContext.jsx - Dashboard API client
dashboard/src/lib/api.js - SEO pages
dashboard/seo/pages.js
Clip generation
- Clip pipeline
main.py - Moment selection
clip_selection.py - AI analysis
gemini_worker.py - LLM backend
llm_backend.py - Transcription and subtitles
transcribe_backends.py - Smart reframing
reframe_v2.py
Creation tools
- Social publishing
yt_clients.py - AI Shorts
dashboard/src/components/SaaShortsTab.jsx - YouTube Studio
dashboard/src/components/ThumbnailStudio.jsx - UGC gallery
dashboard/src/components/UGCGallery.jsx
Cloud platform
- API and job service
app.py - Cloud authentication
cloud/auth.py - Usage and billing metering
cloud/metering.py - Cloud database
cloud/database.py - Cloud data models
cloud/models.py - Cloud configuration
cloud/config.py - Durable video storage
cloud/storage.py
Rendering and media
- Render service
render-service/src/server.ts - Render worker
render-service/src/render-worker.ts - Video compositions
remotion/src/compositions/ShortVideo.tsx
Other components
- Creator
Connections 23
- Creator → Dashboard app: uses
- Dashboard app → Dashboard API client: requests through
dashboard/src/App.jsx - Dashboard API client → API and job service: calls API
- Dashboard app → Sign-in and account: uses authentication
dashboard/src/main.jsx - API and job service → Clip pipeline: runs jobs
app.py - Clip pipeline → Moment selection: imports and uses
main.py - Clip pipeline → AI analysis: imports and uses
main.py - Clip pipeline → Transcription and subtitles: imports and uses
main.py - Clip pipeline → Smart reframing: imports and uses
main.py - LLM backend → AI analysis: delegates to
llm_backend.py - Dashboard app → AI Shorts: shows tool
dashboard/src/App.jsx - Dashboard app → YouTube Studio: shows tool
dashboard/src/App.jsx - Dashboard app → UGC gallery: renders gallery
dashboard/src/App.jsx - Creator → Social publishing: publishes clips
- Creator → SEO pages: browses pages
- Render service → Render worker: dispatches render
render-service/src/server.ts - Render worker → Video compositions: renders composition
render-service/src/render-worker.ts - Cloud authentication → Cloud database: loads user data
cloud/auth.py - Cloud authentication → Usage and billing metering: checks entitlement
cloud/auth.py - Usage and billing metering → Cloud database: reads usage records
cloud/metering.py - Cloud database → Cloud data models: registers schema
cloud/database.py - Cloud database → Cloud configuration: configures engine
cloud/database.py - Durable video storage → Cloud configuration: uses settings
cloud/storage.py