All systems OKView Status
// STREAMION.BOT DOCS

All about streamion.bot.

Sign-in flow, chat commands, event responses, alerts, music integrations — the full reference for your bot configuration.

Watchtime

streamion.bot can track how long each viewer has watched your channel and let them check it in chat with !watchtime. A leaderboard of your most loyal viewers lives in the dashboard. Watch time is tracked per channel and only accrues while you're live.

Turning it on

Watch time is off by default. Enable it on Settings → Watchtime (/settings/watchtime, Owner / Admin only) with the Track watch time toggle.

The bot must be a moderator. Tracking reads Twitch's "who's in chat" list, which requires the streamionbot account to be a moderator in your channel. Type /mod streamionbot in your chat before turning tracking on — otherwise it stays idle.

How it's measured

While you're live, streamion.bot samples your chatter list about once a minute and credits everyone currently present with the elapsed time — the same presence-based method tools like StreamElements use. Viewers don't have to type to earn time; just being in chat counts. Each sample is capped, so a hiccup can't dump hours at once.

Time keeps adding up across streams. If a viewer renames their Twitch account, the new name starts a fresh total (the old one keeps its time).

The !watchtime command

PropertyDefault
Trigger!watchtime
Alias!wt
PermissionEveryone
Per-user cooldown15s

It reports the caller's own watch time — for example "Alice has watched for 5 days 3 hours." Viewers with nothing recorded yet get a friendly "…no watch time has been recorded for you yet." As with every built-in command, the trigger, alias, permission, and cooldowns can be changed on the Commands page.

Watch-time leaderboard

Statistics → Chat Stats (/statistics/chat) shows a watch-time leaderboard — your viewers ranked by total watch time, with a search box to find someone specific. Any signed-in workspace member can view it.

Importing existing watch time

Moving from another tool? On the Watchtime settings page you can import existing totals so loyal viewers don't start from zero:

  • Formats — a CSV of username,minutes (comma, semicolon, or tab separated; an optional header is fine), or a JSON array like [{ "username": "alice", "minutes": 1234 }]. Files up to 16 MB.
  • From StreamElements — export your points leaderboard, convert points to minutes, and upload it.
  • Raise-only — an import never lowers an existing total, and running it twice won't double-count, so re-importing is safe.