ENDE

Watchtime

When enabled, the bot tracks watchtime for every viewer in the chatter list. Viewers do not need to write; they only have to be present in chat.

Dashboard overview

On this page you manage watchtime, adjust cooldowns, maintain entries, and exclude specific logins from tracking.

Commands

  • !watchtime @user shows that viewer's watchtime. Without a user, it shows your own watchtime.
  • !topwatchtime shows the top 5 of the watchtime list.
  • !watchrank @user shows this viewer's rank in the watchtime list. Without a user, it shows your own rank.

Configuration

Enable the feature with the toggle and set per-command cooldowns (separate for global and per-user). Further down you can exclude specific logins from tracking, e.g. known bots. If you exclude users, watchtime for them is no longer collected; existing entries must be deleted manually if needed.

Import

Using the green Import button you can bring in existing watchtime from other sources. The dropdown offers two options:

StreamElements

If you previously used StreamElements and already collected watchtime there, you can import those times. Click Import → StreamElements, enter your channel ID and JWT token, and click Import. You can find both here: https://streamelements.com/dashboard/account/channels. The ID and token are not stored; they are used only once for the import.

CSV

With Import → CSV you can import watchtime from any source via CSV file. You can either upload a file or paste the CSV content directly.

Expected format: One row per user with username and minutes, separated by comma or semicolon. A header row is optional.

username,minutes
nightbot,1200
streamelements,530

If individual lines are invalid, they are shown with an error message – valid lines are still imported.

Important: Existing watchtime for matching users will be overwritten, not added.

Management

In the list below you can edit or delete existing entries. You also see when each user was last active in chat. Click Delete all entries to clear the entire list. Warning: entries are permanently lost.