Songs2VID OSS

Payment-free, self-hosted software for creating videos from cover art and audio, then uploading them to YouTube. All features are available in every deployment; there are no plans, credits, purchases, subscriptions, or Stripe integration.

Quick start with Docker

1. Copy .env.example to .env and set NEXTAUTH_SECRET, GOOGLE_CLIENT_ID, and GOOGLE_CLIENT_SECRET.
2. In Google Cloud Console, enable YouTube Data API v3 and add http://localhost:3000/api/auth/callback/google as an OAuth redirect URI.
3. Start the stack:

docker compose up -d --build

Open http://localhost:3000.

Local development

docker compose -f docker-compose.dev.yml up -d
npm install
npm run db:migrate
npm run dev:all

The web app runs on http://localhost:3000. dev:all starts both the Next.js app and BullMQ worker.

Stack

• Next.js 15, TypeScript, Tailwind
• PostgreSQL and Prisma
• Redis and BullMQ
• NextAuth with Google OAuth
• FFmpeg
• YouTube Data API v3

Documentation, including the REST API reference, is at docs.songs2vid.com.