Vividdit
Free, self-hostable download gates for SoundCloud artists. Fans unlock an HQ
file (WAV/AIFF/ZIP) by joining your email list and/or proving like · repost ·
follow with a single screenshot — verified by AI using your own OpenAI or
OpenRouter key (BYOK). No SoundCloud API, no browser automation: the track
stays public, the download is the reward. Because verification is screenshot +
AI rather than a platform API, the gate keeps working through platform API
changes.
Not affiliated with, endorsed by, or sponsored by SoundCloud, Instagram, or
Spotify. You are responsible for complying with each platform's terms when
incentivizing engagement.
How it works
- Creator publishes a gate: SoundCloud track + private HQ file + unlock
requirements + immutable URL (
/artist/track-slug).
- Fan lands on the gate from the track's buy-link, does the actions on the
SoundCloud track page, pastes a one-time proof code into the comment box,
and uploads one screenshot.
- AI verification (OpenAI Responses API, structured outputs) approves,
rejects with a fix-it message, or routes to the creator's review queue.
Server-side policy has the final say; fraud signals veto auto-approval.
- Delivery: approved fans download via short-lived signed URLs — on the
page instantly, or via a tokenized email link after manual review.
Stack
Next.js (App Router) · TypeScript · Tailwind + shadcn/ui · Supabase
(Auth/Postgres/Storage, full RLS) · Resend · Vercel.
Development
Prereqs: Node 20+, pnpm, Docker (OrbStack/Docker Desktop).
pnpm install
pnpm exec supabase start # local stack; prints keys
cp .env.example .env.local # fill in values from `supabase status`
pnpm dev
Useful local URLs: Studio http://127.0.0.1:54323, Mailpit (auth emails)
http://127.0.0.1:54324.
Tests
pnpm test # unit + integration (integration self-skips without the local stack)
Coverage map: docs/TEST-PLAN.md.
Deploying
Runbook: docs/DEPLOY.md — hosted Supabase, Vercel, Resend,
cron, and the post-deploy checklist.
Docs
Heads up if you fork this 👀
The tool has its own access gate: to use the dashboard, a creator must follow
the original author on Instagram
(@vividfeverdreams), verified
the same screenshot way. That's intentional and hardcoded in
src/lib/creator-access-constants.ts. The AGPL gives you the freedom to remove
it… but a follow is a pretty small price. 🙂
License
GNU AGPL-3.0. Vividdit runs as a network service, so the AGPL
requires that if you deploy a modified version for others to use, you make your
source available to those users under the same license.
