What is this?
StarLive is a self-hosted live-streaming and interaction platform: it handles the video stream, real-time danmaku/gifts/red-packets/lottery, moderation, and a built-in StarCoin virtual-currency economy. It's a rewrite of the legacy LDLive, moving from serverless HTTP polling to a standalone NestJS backend with persistent Socket.IO connections.
StarLive is a self-hosted live-streaming and interaction platform: it handles the video stream, real-time danmaku/gifts/red-packets/lottery, moderation, and a built-in StarCoin virtual-currency economy. It's a rewrite of the legacy LDLive, moving from serverless HTTP polling to a standalone NestJS backend with persistent Socket.IO connections.Is this one app or several separate services I have to wire together?It's a pnpm-workspaces monorepo containing a NestJS backend, a React/Vite frontend, and an optional FFmpeg recording worker, but the Docker deploy ships them as one unified app exposed on a single port.
It's a pnpm-workspaces monorepo containing a NestJS backend, a React/Vite frontend, and an optional FFmpeg recording worker, but the Docker deploy ships them as one unified app exposed on a single port.How do I get it running?Use the one-click Docker deploy (docker compose or the prebuilt GHCR image) which exposes everything on port 3000; the first visit launches a setup wizard that creates the admin account.
Use the one-click Docker deploy (docker compose or the prebuilt GHCR image) which exposes everything on port 3000; the first visit launches a setup wizard that creates the admin account.What do I need running alongside the app itself?Redis (self-hosted or Upstash) for data storage and MediaMTX for self-hosted stream ingest/playback; locally you can spin up just these two with `docker compose up -d redis mediamtx`. Only two env vars are strictly required: REDIS_URL and JWT_SECRET.
Redis (self-hosted or Upstash) for data storage and MediaMTX for self-hosted stream ingest/playback; locally you can spin up just these two with `docker compose up -d redis mediamtx`. Only two env vars are strictly required: REDIS_URL and JWT_SECRET.Does it record streams automatically?No — recording goes through a separate FFmpeg worker that transcodes and persists VOD, but it's off by default and must be explicitly enabled.
No — recording goes through a separate FFmpeg worker that transcodes and persists VOD, but it's off by default and must be explicitly enabled.Can I switch between self-hosted streaming and a cloud provider?Yes — the admin panel lets you switch from self-hosted MediaMTX (RTMP in / HLS out) to Mux as a cloud provider with RTMPS ingest and auto-recorded VOD, with zero SDK integration needed. Rooms created under one provider keep using it even after you switch.
Yes — the admin panel lets you switch from self-hosted MediaMTX (RTMP in / HLS out) to Mux as a cloud provider with RTMPS ingest and auto-recorded VOD, with zero SDK integration needed. Rooms created under one provider keep using it even after you switch.What is StarCoin and how does the money side work?StarCoin is the platform's built-in virtual currency used for gifts and red packets. It supports top-up through multiple payment gateways and withdrawal with fees and fund freezing, all tracked in a transaction ledger.
StarCoin is the platform's built-in virtual currency used for gifts and red packets. It supports top-up through multiple payment gateways and withdrawal with fees and fund freezing, all tracked in a transaction ledger.Which payment gateways are supported?The PaymentProvider abstraction ships adapters for YiPay, Alipay, WeChat Pay APIv3 Native, Stripe, and a mock gateway for testing, each independently configurable and toggleable from the admin panel.
The PaymentProvider abstraction ships adapters for YiPay, Alipay, WeChat Pay APIv3 Native, Stripe, and a mock gateway for testing, each independently configurable and toggleable from the admin panel.Can I run it without touching environment variables for config?Almost everything besides Redis connection and JWT secret is configured live from /admin → Settings (payment gateways, OAuth, feature flags, site URL), stored in Redis and taking effect instantly; matching env vars only act as fallbacks.
Almost everything besides Redis connection and JWT secret is configured live from /admin → Settings (payment gateways, OAuth, feature flags, site URL), stored in Redis and taking effect instantly; matching env vars only act as fallbacks.