Docs › Tools › Top Emotes Counter

Tools docs

Top Emotes Counter overlay

The emotes your viewers use in chat fall across your stream as their own images, with the density, size, fall speed and duration you choose.

The Top Emotes Counter lists the emotes your chat uses most, each with its picture and how many times it has been used. The emotes are pictures of the ones your chat uses from Kick, Twitch, Rumble and YouTube and from 7TV. It is a transparent browser source that reads your chat directly from your browser, read-only and with no login, so it needs no account.

Build it

Open the Top Emotes Counter builder from the Tools page, name your channels, set the counter, and copy the link. The preview at the top counts sample emotes so you can see the look. It reads no chat, so your channel names and keys stay on the builder page, and it reloads a moment after you change a setting. To see it count your own chat, open the link. Copy URL and Open stay off until at least one channel is filled in.

Paste the link into a browser source in OBS or your streaming app, set the source to the size of your stream’s frame, and keep its background transparent.

Channels

Fill in Kick channel and Twitch channel with just the name. For Rumble, paste your Rumble Live-Stream-API URL. It embeds your secret key, so it stays in the link’s # part, which browsers never send to a server, and Dual IRL’s server relays the requests Rumble does not allow from a browser. For YouTube, fill in YouTube Data API key with your own key, plus either YouTube channel handle or, under Advanced YouTube options, YouTube live video URL, which is used instead of the handle. These work as they do in Merged chat and Emote Rain, which this overlay shares its connections with.

Counter

Every time an emote is used in a chat line it counts once, so a line with the same emote three times adds three. The same emote is one entry wherever it was used, on any platform and in any line. Only emotes are counted, not words, and an emote whose picture does not load is left out.

Include 7TV emotes
On to start. Matches 7TV’s global emotes and the channel’s own set against what viewers type, so they are counted as pictures. BTTV is not supported.
Include 7TV emotes that 7TV rates suggestive
Off to start, because this overlay is composited onto a live broadcast. Those emotes are not counted unless you turn it on.
Emotes listed
From 1 to 20, starting at 5. How many of the most used emotes are shown, the most used first. Emotes used equally often are listed with the most recently used first.
Size
From 16 to 96, starting at 48. How tall each emote is in a frame 1080 pixels high; it scales with the frame. A list that would not fit the frame gets smaller emotes.
Counting period
Rolling window counts only the uses of the last few minutes, so the list follows what chat is using now. Whole session counts every use since the source loaded.
Window length
From 1 to 120 minutes, starting at 10. Shown for a rolling window. A use stops counting once it is older than this.
Look
List puts each emote and its count on a line. Compact row puts the emotes side by side with the counts beneath. A count of a thousand or more is shown short, like 1.2k.
Position
Which corner of the source the counter sits in: top left, top right, bottom left or bottom right.

Clearing the counts

The counts live only in the page and are never stored, so they start again at zero whenever the browser source reloads, which OBS also does when Shutdown source when not visible is on. To clear them while you are live, open the source’s Interact window in OBS and double-click it or press R. The builder’s preview has a Reset counts button.

Landscape and portrait

The overlay fills whatever size you give the browser source. Sizes follow the frame’s shorter side, so a 1920 by 1080 frame and a 1080 by 1920 frame show emotes of the same size, and the list shrinks where that many emotes would not fit. The Landscape and Portrait buttons above the preview only change the shape of the preview, not the link.

Messages

The page counts page loads like every tool page, and the count never includes the channel names or keys in the link.

Advanced: change it in the link

SettingValuesStarts as
kick, twitch, rumbleurlchannel name, channel name, secret linknone
youtube, ytvideo, ytkeychannel handle, live video link or id, your Data API keynone
seventv1 or 01
nsfwemotes1 to turn onoff
count1 to 205
periodwindow or sessionwindow
minutes1 to 12010
layoutlist or rowlist
size16 to 9648
cornertl, tr, bl or brtl
sample1 to count built-in sample emotes and read no chatoff