Songs2VID/songs2vid
1
0
Fork 0
mirror of https://git.atakanozban.com/Songs2VID/songs2vid.git synced 2026-10-04 02:38:28 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity
Songs2VID is an automation tool that converts your audio and image files into high-quality videos and uploads them directly to YouTube.
7 Commits 2 Branches 0 Tags 132 MiB
TypeScript 96%
CSS 1.9%
JavaScript 1.5%
Dockerfile 0.6%
6bc98606eb
Go to file
Atakan Doğan Özban 6bc98606eb Update README.md
2026-08-03 05:57:28 +00:00
app Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
assets Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
components Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
docs Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
hooks Initial OSS scaffold from Songs2VID (pre-strip) 2026-08-03 06:15:05 +02:00
lib Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
prisma Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
public Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
scripts Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
types Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
worker Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
.dockerignore Initial OSS scaffold from Songs2VID (pre-strip) 2026-08-03 06:15:05 +02:00
.env.example Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
.eslintrc.json Initial OSS scaffold from Songs2VID (pre-strip) 2026-08-03 06:15:05 +02:00
.gitignore Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
docker-compose.dev.yml Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
docker-compose.yml Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
Dockerfile Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
DOCKERHUB_OVERVIEW.md Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
LICENSE Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
next-env.d.ts Initial OSS scaffold from Songs2VID (pre-strip) 2026-08-03 06:15:05 +02:00
next.config.ts Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
package-lock.json Strip Songs2VID to a payment-free self-hosted OSS core. 2026-08-03 06:52:00 +02:00
package.json Close OSS self-host gaps: in-repo API docs, legal notes, and packaging. 2026-08-03 07:36:08 +02:00
postcss.config.mjs Initial OSS scaffold from Songs2VID (pre-strip) 2026-08-03 06:15:05 +02:00
README.md Update README.md 2026-08-03 05:57:28 +00:00
tailwind.config.ts Initial OSS scaffold from Songs2VID (pre-strip) 2026-08-03 06:15:05 +02:00
tsconfig.json Initial OSS scaffold from Songs2VID (pre-strip) 2026-08-03 06:15:05 +02:00

README.md

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.

Songs2VID Dashboard

Quick start (Docker)

Published image: atakanozban/songs2vid:latest

  1. Clone this repo (or copy docker-compose.yml + .env.example).
  2. Copy .env.example to .env and set at least:
    • NEXTAUTH_SECRET
    • GOOGLE_CLIENT_ID
    • GOOGLE_CLIENT_SECRET
  3. 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
  4. 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)
  • Always-on self-hosted entitlements (no quota paywall)

API documentation

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

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

License

MIT