Skip to main content

Connecting Platforms

Connect your streaming platforms and services to Lumio from Dashboard → Connections (/dashboard/connections).

What Can Be Connected

Different platforms plug into Lumio in different ways. Only the first group uses a channel connection — the OAuth link that lets Lumio read chat and events for your channel.

PlatformChannel connectionBotLoginOther
TwitchYes — chat, events, moderation, rewardsYesYes
YouTubeYes — chat, super chats, membershipsYesYes
KickYes — chat, events, moderationYesYes
TrovoYes — chat, eventsYesYes
SpotifyYes — playback, playlists
DiscordYes (static bot token)YesGuild integration
ShopifyIntegration

The same page also holds the non-OAuth connections: OBS (WebSocket), Streamer.bot, and StreamElements tokens for tip ingestion.

Before You Connect

Lumio does not ship shared platform credentials. Each account brings its own OAuth application per platform:

  1. Create the OAuth app on the platform's developer console and register Lumio's callback URL — see OAuth Provider Setup.
  2. In Lumio, open Connections → App Credentials (/dashboard/connections/credentials) and save the Client ID and Client Secret for that platform. They are stored AES-256-GCM encrypted.

Until credentials exist, the platform card shows a Set up credentials button instead of Connect.

How to Connect

  1. Go to Dashboard → Connections.
  2. Click Connect on the platform card.
  3. Authorize the requested scopes on the platform's consent screen.
  4. You are redirected back and the card flips to Connected.

You only enter credentials once per platform. A connected card also offers Reconnect, which re-runs the OAuth flow against the same credentials — use it after Lumio adds a scope, or when a token has expired and cannot be refreshed.

One Connection Per Platform

Each account holds at most one channel connection per platform — the channel_connections table is unique on (account, platform). Connecting a second Twitch channel to the same account replaces the first. Use separate Lumio accounts for separate channels.

Your login connections are tracked separately, so signing in with Twitch and also connecting a Twitch channel are two independent records.

Permissions

ActionPermission
See the Connections page and connection statusconnections:read
Save App Credentials, start the OAuth flowconnections:create (the buttons are additionally gated on connections:edit in the UI)
Disconnect a platformconnections:delete

An administrator can disable a provider globally; a disabled platform's card is shown but cannot be connected.

Next Steps