How gundpa45/shoritfy works
Shortify turns a submitted YouTube URL into AI-selected short clips that users can preview, download, and share. The main flow runs from Creator Studio through the backend’s URL pipeline, which fetches video details and downloads media before requesting clip generation from the AI service. That service transcribes, analyzes, ranks, and cuts clips; the backend exposes the resulting media and data to the frontend. The README documents the service boundary and user workflow; some frontend-to-API wiring and AI endpoint details were not excerpted, so those edges cite the README.
Main entry points: youtube.pipeline.ts YouTube pipeline · clip_generator_service.py Clip generator · app.ts Media serving · ai.service.ts AI client
Components 28
Frontend experience
- Creator Studio
Frontend/src/pages/CreatorStudio.tsx - Clip results
Frontend/src/components/StudioResults.tsx - Sign-in pages
Frontend/src/pages/AuthPage.tsx - App routing
Frontend/src/App.tsx
Backend orchestration
- URL routes
Backend/src/routes/url.route.ts - URL controller
Backend/src/controllers/url.controller.ts - YouTube pipeline
Backend/src/pipeline/youtube.pipeline.ts - URL normalization
Backend/src/utils/youtube.utils.ts - Video details
Backend/src/services/youtube.service.ts - Audio download
Backend/src/services/youtube/download.service.ts - Video download
Backend/src/services/youtube/downloadVideo.service.ts - AI client
Backend/src/services/ai.service.ts - Media serving
Backend/src/app.ts - Auth routes
Backend/src/routes/auth.routes.ts - Auth handlers
Backend/src/controllers/user.controller.ts
AI clip generation
- AI API
AI-Service/app.py - Clip endpoint
AI-Service/api/clip.py - Clip generator
AI-Service/services/clip_generator_service.py - Whisper transcription
AI-Service/services/whisper_service.py - Transcript compression
AI-Service/services/compress_transcript_service.py - Transcript chunking
AI-Service/services/transcript_chunk_service.py - Moment analysis
AI-Service/services/llm_service.py - Gemini model
AI-Service/models/gemini_model.py - Clip prompt
AI-Service/prompts/clip_prompt.py
Media processing
- Clip cutting
AI-Service/services/ffmpeg_service.py - Generated clips
- Downloaded video
Other components
- User
Connections 30
- User → Creator Studio: submits URL
- Creator Studio → URL routes: requests clips
- URL routes → URL controller: dispatches
Backend/src/routes/url.route.ts - URL controller → YouTube pipeline: runs pipeline
Backend/src/controllers/url.controller.ts - YouTube pipeline → URL normalization: normalizes URL
Backend/src/pipeline/youtube.pipeline.ts - YouTube pipeline → Video details: fetches details
Backend/src/pipeline/youtube.pipeline.ts - YouTube pipeline → Audio download: downloads audio
Backend/src/pipeline/youtube.pipeline.ts - YouTube pipeline → Video download: downloads video
Backend/src/pipeline/youtube.pipeline.ts - YouTube pipeline → AI client: requests clips
Backend/src/pipeline/youtube.pipeline.ts - Video download → Downloaded video: writes video
- AI client → AI API: calls AI service
- AI API → Clip endpoint: mounts endpoint
AI-Service/app.py - Clip endpoint → Clip generator: generates clips
AI-Service/api/clip.py - Clip generator → Whisper transcription: transcribes
AI-Service/services/clip_generator_service.py - Clip generator → Transcript compression: compresses transcript
AI-Service/services/clip_generator_service.py - Clip generator → Transcript chunking: creates chunks
AI-Service/services/clip_generator_service.py - Clip generator → Moment analysis: analyzes chunks
AI-Service/services/clip_generator_service.py - Moment analysis → Gemini model: generates analysis
AI-Service/services/llm_service.py - Moment analysis → Clip prompt: uses prompt
AI-Service/services/llm_service.py - Clip generator → Clip cutting: cuts ranked clips
AI-Service/services/clip_generator_service.py - Clip cutting → Generated clips: writes clips
AI-Service/services/ffmpeg_service.py - AI client → Media serving: returns media URLs
- Media serving → Generated clips: serves clips
Backend/src/app.ts - Media serving → Downloaded video: serves video
Backend/src/app.ts - Media serving → Clip results: provides previews
- Clip results → User: offers downloads
- User → Sign-in pages: signs in
- Sign-in pages → Auth routes: submits credentials
- Auth routes → Auth handlers: dispatches handlers
Backend/src/routes/auth.routes.ts - App routing → Creator Studio: routes studio
Frontend/src/App.tsx