TEASEDocs
ProductsStreamHow-to

Add a live viewer counter

An honest, updating count of who's actually watching — not a decorative number.

The "Online" layer is an ordinary text line carrying a placeholder token; Stream substitutes the real number into it on every reconcile, roughly every ten seconds, without the frame blinking.

Add it

Add an Online layer, or drop its token into any text layer's line — for example Watching {онлайн}. As with the timer, the current token is the literal Cyrillic string {онлайн}, documented here as it exists in the source (app/products/stream/core/scene_layers.py).

How the number is computed

Where a platform reports its own viewer count (Chaturbate does today), Stream uses that number directly. Where it doesn't, Stream counts unique people seen in chat over the last five minutes — deliberately lower than the real audience, since silent viewers are invisible that way. The creator's own chat lines are excluded, so typing in your own chat can't inflate your number.

Zero viewers and nothing to count look the same, on purpose

While no platform chat is connected, the counter shows 0 and the panel says plainly that it isn't looking anywhere yet — not "nobody is watching." Only platforms whose room Stream actually reads are counted.

How to verify it worked

Go live at zero — the number catches up instead of staying at zero for the rest of the broadcast, and a status card breaks the total down per platform along with where each platform's number came from.

What's next

Put landing content on air — show promo content from your landing page in the frame.

On this page