a8beabfe36
- LayoutStudio was buried after the per-audio list, making settings invisible before submit; moved it right after the Files section so layout/watermark settings are always visible in the workflow - Add -preset ultrafast and -r 1 to both libx264 encode paths; without a preset FFmpeg defaults to medium and wastes time on motion estimation for still images; -r 1 avoids 25x frame synthesis overhead on 1080p |
||
|---|---|---|
| app | ||
| assets | ||
| components | ||
| docs | ||
| hooks | ||
| integrations/n8n | ||
| lib | ||
| prisma | ||
| public | ||
| scripts | ||
| types | ||
| worker | ||
| .dockerignore | ||
| .env.example | ||
| .eslintrc.json | ||
| .gitignore | ||
| docker-compose.dev.yml | ||
| docker-compose.yml | ||
| Dockerfile | ||
| DOCKERHUB_OVERVIEW.md | ||
| LICENSE | ||
| next-env.d.ts | ||
| next.config.ts | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.mjs | ||
| README.md | ||
| tailwind.config.ts | ||
| tsconfig.json | ||
🎬 Songs2VID
Payment-free, self-hosted software that turns cover art and audio into YouTube videos (FFmpeg encoding + BullMQ jobs). Every deployment has full entitlements — there are no plans, credits, purchases, subscriptions, paywalls, or Stripe.
Sign in with Google, open the dashboard, and create videos. Settings cover account, YouTube connection, and API keys only.
🚀 Quick start (Docker)
Published image: atakanozban/songs2vid:latest
- Clone this repo (or copy
docker-compose.yml+.env.example). - Copy
.env.exampleto.envand set at least:NEXTAUTH_SECRETGOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRET
- In Google Cloud Console, enable YouTube Data API v3
and add an OAuth redirect URI:
- Local:
http://localhost:3000/api/auth/callback/google - Production:
https://YOUR_DOMAIN/api/auth/callback/google
- Local:
- Start the stack (web + worker + Postgres + Redis):
docker compose up -d
Compose uses the published image by default (atakanozban/songs2vid:latest) and can also
build from this repo (docker compose up -d --build).
Open http://localhost:3000 → sign in → dashboard.
No Stripe keys, billing env vars, or edition flags are required. Watermarks are optional; OSS does not force a free-tier SaaS badge paywall.
✨ Features
- 📦 Batch: one cover (or per-track covers) + many audio files → YouTube uploads
- 🖼️ Classic letterbox and art-track layouts (blur backgrounds, typography, fine-tuning)
- 💧 Custom watermarks (badge, text, or logo) and curated or uploaded fonts
- ▶️ YouTube playlists, privacy, tags, resolution, categories
- 🔌 REST API for automation (keys under Dashboard → Settings → API key)
- 🤖 n8n community node
n8n-nodes-songs2vid+ optionalwebhookUrlcallbacks - 🔓 Always-on self-hosted entitlements (no quota paywall)
📚 API documentation
- In-repo: docs/api/overview.md, docs/api/endpoints.md, docs/n8n.md
- Live site: docs.songs2vid.com/docs/api/overview
- Machine-readable discovery:
GET /api/v1(no auth; no billing routes) - Node package source:
integrations/n8n
🛠️ Local development
docker compose -f docker-compose.dev.yml up -d
cp .env.example .env # then edit secrets / Google OAuth
npm install
npm run db:migrate
npm run dev:all
- App: http://localhost:3000
dev:allruns Next.js and the BullMQ worker
⚙️ Environment
See .env.example for the required and optional variables. Matching guide:
docs.songs2vid.com/docs/environment.
⚖️ Legal (self-hosted)
In-app Privacy and Terms pages describe self-hosted responsibility: the operator of each instance controls data and access; this software does not process payments. They are not the paid cloud terms for songs2vid.com.
🧱 Stack
- Next.js 15, TypeScript, Tailwind
- PostgreSQL and Prisma
- Redis and BullMQ
- NextAuth with Google OAuth (YouTube scopes)
- FFmpeg
- YouTube Data API v3
🔗 Links
- Primary source hub: git.atakanozban.com/Songs2VID
- Docs: docs.songs2vid.com
- Docker Hub: atakanozban/songs2vid
- n8n node (npm):
n8n-nodes-songs2vid - Web UI / hosted SaaS (secondary mirror): songs2vid.com