Unified Chat

Merges live chat from YouTube, Twitch, Kick, Discord, Rumble, Trovo, DLive and Facebook into one scrolling dashboard, pushed to your browser over Server-Sent Events. Includes a YouTube live-title editor so you can rename a running stream without opening Studio.

What you need

Install

Download this folder to your Docker host, then run:

cd unified-chat
cp .env.example .env
nano .env                 # fill in at least one platform + AUTH_USER/AUTH_PASS
docker compose up -d
docker compose logs -f    # confirm your platforms loaded

Compose builds the image from the files in the folder, so you don't need a Docker Hub account or a prebuilt image. If you edited .env on Windows, run sed -i 's/\r$//' .env first or every value gets a trailing carriage return.

Configure

Every platform is optional. Fill in only the ones you use — the rest are skipped and logged as disabled. The startup log ends with a Platforms enabled: line so you can see exactly what loaded. A platform with bad credentials logs an error and drops out; it can't stop the others or prevent the app from starting.

.env.example documents where to get every credential.

Run it

Optional: YouTube title editor

To rename a running livestream from the dashboard, set YT_OAUTH_CLIENT_ID, YT_OAUTH_CLIENT_SECRET and YT_OAUTH_REDIRECT, then visit /auth/youtube/start once to authorize. The refresh token is saved to the mounted tokens/ folder and survives rebuilds. Chat relay works fine without this.

The redirect URI must match what you registered in Google Cloud exactly — same scheme, host and port — and your browser has to be able to reach it.

Unraid

unified-chat.xml is a Community Applications template, and it needs no Docker Hub account and no published image — it runs the official node:20 image and downloads the app files from this site into your appdata folder on start. Drop the XML in /boot/config/plugins/dockerMan/templates-user/, fill in your platform variables, set AUTH_USER/AUTH_PASS, and leave the app data path at /mnt/user/appdata/unified-chat.

First boot takes a minute or two while npm install runs — watch the container log. Restarting re-downloads the latest version. This path runs as root without the healthcheck or privilege-dropping entrypoint; for those on Unraid, use the Docker Compose Manager plugin with the install above.

Files

README.md  ·  install.txt  ·  .env.example  ·  docker-compose.yml  ·  Dockerfile  ·  unified-chat.js  ·  unified-chat.xml

X / Twitter is not supported — the adapter was never written, and any X_* variables are ignored.