Skip to main content

Viewer Management

The Viewers page is your cross-platform community hub — combine chat from every source in one place, track regulars, and merge identities for viewers who use you on multiple platforms.

It has two main tabs:

  • Live Chat — real-time feed combining all platforms
  • Viewer Manager — viewer table with editing, notes, merge / split

What you'll need​

  • At least one source connected
  • Some chat / donations already coming through (otherwise there's nothing to show)

Step 1 — Live Chat across all platforms​

  1. Go to Viewers (sidebar) → the Live Chat tab
  2. The feed combines messages from YouTube + Twitch + Streamlabs in one place
  3. Each message has a platform icon, avatar, badges (Super, Sub, Bits, Gift, Member)

Available controls:

  • Filter by platform — show only YT / Twitch / Streamlabs
  • Search — by name or message text
  • Pause / Resume — pause the feed (the buffer keeps the last 300 messages)
  • Clear — wipe what's on screen
  • Auto-scroll toggle

Step 2 — Pop-out chat window​

If you want to see chat while gaming fullscreen:

  1. In the Live Chat tab, click Pop out
  2. Electron opens a separate window (/chat-window)
  3. The window has an Always on Top toggle to keep it pinned
  4. Same filter / pause / auto-scroll as the main window

Step 3 — Viewer Manager​

The Viewer Manager tab shows a table of every viewer:

  • Search by name
  • Sort by Last seen / Message count / Total donated
  • Click a row to:
    • Edit nickname — set a short name for the viewer (used in TTS / overlay)
    • Edit notes — quick notes (e.g. "VIP", "moderator")
  • Delete — remove the viewer record (doesn't touch donation/chat history)

Step 4 — Merge duplicate users across platforms​

The same person showing up on YouTube + Twitch under different names? You can merge them into a single viewer record:

  1. The app will suggest merges automatically in the Suggestions banner at the top of Viewer Manager
  2. Click a suggested name → click Accept → the 2 records merge
  3. Or merge manually: pick viewer 1 → click Merge → pick another viewer → confirm

After merging — chat history + donation count combine.

Step 5 — Split an identity​

If you merge by mistake or want to undo:

  1. Click a viewer's name → open Detail Modal
  2. In the Identities tab → click Split next to the identity you want to break out
  3. That identity becomes its own separate viewer record

Step 6 — Viewer Detail Modal​

Click a viewer's name anywhere (Live Chat / Viewer Manager / History) → a popup opens with:

  • Identities across every platform
  • Stats: message count, donation count, total donated, first/last seen
  • Activity history — combined chat + donation timeline
  • Edit nickname / notes in one place

Step 7 — Set chat retention​

Old chat messages are deleted automatically to keep the DB lean (the per-viewer message counter stays):

  1. Go to Settings → Backup tab
  2. The Chat Retention section
  3. Flip chatAutoCleanupEnabled
  4. Set Retention Days (slider 1–365 — default 30)
  5. Cleanup runs every 6 hours

:::tip 30 days is a good default For most streamers — 30 days is the sweet spot between useful history and DB size. :::

Tips & Troubleshooting​

  • Viewer changed their name: use the nickname field in Viewer Manager — it'll be used in TTS / overlay instead of the platform-side name.
  • Suggestions not showing: the app uses name similarity — very different names won't be suggested, but you can still merge manually.
  • Can't find the pop-out window: it might be hidden behind the main window — Alt+Tab or click Pop out again (it focuses the existing window).
  • Chat not updating: check the Pause toggle + check that your source connections are still green.

See also​