How furqanraza4343/yt_clipping_automation works
ShortsPilot automates turning configured videos, YouTube channels, or watch folders into reviewed and scheduled Shorts. Its worker coordinates discovery, OpenShorts processing, deterministic safety and quality checks, metadata generation, scheduling, and YouTube publication; SQLite records resumable state. Operators manage sources, approvals, integrations, and health through the dashboard or commands. The README documents the principal workflow and optional Drive and Telegram capabilities; sampled excerpts do not expose every internal call, so some subsystem links are documented at workflow level.
Main entry points: supervisor.py Pipeline supervisor · app.py Dashboard · discovery.py Video discovery · engine_client.py Engine client
Components 21
Clip workflow
- Sources and channels
shortspilot/sources.py - Video discovery
shortspilot/discovery.py - Engine client
shortspilot/engine_client.py - OpenShorts engine
- Media checks
shortspilot/media.py - Clip polishing
shortspilot/polish.py - Safety and gates
shortspilot/gates.py - Metadata generation
shortspilot/metadata.py - Slot scheduler
shortspilot/scheduler.py - Source windows
shortspilot/windows.py
Worker and state
- Pipeline supervisor
shortspilot/supervisor.py - SQLite state
shortspilot/db.py - Runtime settings
shortspilot/config.py - YouTube cookies
shortspilot/cookies.py
Publishing integrations
- DeepSeek client
shortspilot/llm.py - YouTube publishing
shortspilot/youtube.py - Drive delivery
shortspilot/drive.py - Telegram controls
shortspilot/notify.py
Operator controls
- Dashboard
shortspilot/web/app.py - Dashboard auth
shortspilot/auth.py
Other components
- Operator
Connections 22
- Operator → Dashboard: manages
README.md - Dashboard → Dashboard auth: authenticates with
shortspilot/web/app.py - Dashboard → Pipeline supervisor: queues commands
shortspilot/web/app.py - Pipeline supervisor → Sources and channels: loads policy
shortspilot/supervisor.py - Pipeline supervisor → Video discovery: discovers videos
README.md - Pipeline supervisor → Engine client: submits jobs
README.md - Engine client → OpenShorts engine: calls API
shortspilot/engine_client.py - OpenShorts engine → Pipeline supervisor: returns clips
README.md - Pipeline supervisor → Media checks: checks clips
shortspilot/supervisor.py - Pipeline supervisor → Clip polishing: processes clips
shortspilot/supervisor.py - Pipeline supervisor → Safety and gates: evaluates clips
README.md - Pipeline supervisor → Metadata generation: requests metadata
README.md - Metadata generation → DeepSeek client: generates text
shortspilot/metadata.py - Pipeline supervisor → Slot scheduler: assigns slots
shortspilot/supervisor.py - Pipeline supervisor → YouTube publishing: uploads and verifies
README.md - Pipeline supervisor → Drive delivery: delivers clips
README.md - Pipeline supervisor → Telegram controls: sends alerts
README.md - Pipeline supervisor → SQLite state: updates state
shortspilot/supervisor.py - Dashboard → SQLite state: reads state
shortspilot/web/app.py - Pipeline supervisor → Runtime settings: uses settings
shortspilot/runtime.py - Video discovery → YouTube cookies: uses cookies
shortspilot/discovery.py - Pipeline supervisor → Source windows: splits long sources
README.md