Docs › Tools › Emote Explosions

Tools docs

Emote Explosions 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.

When someone follows, subscribes, gifts subscriptions or raids, a burst of emotes shoots out of one place on your stream, arcs up and out, falls, and fades away. The emotes are pictures of the ones your chat uses, or ones you name, 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. Subscriptions, gifts and raids need no account; follows are chosen in the builder in your Dual IRL account, which already has your account’s key.

Build it

Open the Emote Explosions builder from the Tools page, name your channels, choose the events and the emotes, set the bursts, and copy the link. The preview at the top sets off a burst of sample emotes every few seconds 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 react to your own events, open the link. Copy URL and Open stay off until at least one channel is filled in and at least one event is chosen.

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.

Events

Choose which events set off a burst. Each event sets off one burst.

Subscription
On to start. A new or renewed subscription on Kick or Twitch, or a new membership on YouTube.
Gifted subscriptions
On to start. A gift of subscriptions on Kick, Twitch or Rumble, or of memberships on YouTube. A gift of many is one burst.
Raid
On to start. A raid or host.
Follow
Off to start. A follow is not an event in chat, so it is read from the alerts of your Dual IRL account, the same ones the Alerts overlay shows. It is chosen in the builder in your account, not in the builder on this site. The @dualirl bot must be on for your account.

To use Follow, open the Emote Explosions builder in your account at dualirl.app, which the Widgets tab of the Chatbot page links to. It is the same builder with your account’s key already in it, so nothing is pasted from your account into a builder. The key stays in the link’s # part and is sent only to Dual IRL, and only to read your follows, so treat a link that carries it like a password. The builder on this site has no account, so the other events work there and Follow is not offered.

Emotes

Include 7TV emotes
On to start. Matches 7TV’s global emotes and the channel’s own set against what viewers type, so they fly 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 do not fly unless you turn it on.
Which emotes fly
The emotes your chat has used since the page opened, only the emotes you name, or both. A burst picks from them at random, so a popular emote may appear many times.
Emote names
Up to 20 names, separated by commas and spelled exactly as the emote is, capitals included. A name is found among the 7TV emotes first and then among the emotes chat has used; a name found in neither is skipped.

Until chat has used an emote, or when none of the names is found, a burst uses emotes from the 7TV catalog so there is always something to show. With 7TV off and nothing used in chat yet there is nothing to throw, and a burst is left out.

Bursts

A burst leaves one place in the middle of the frame, low enough that the emotes have room to arc. Each emote pops in, is thrown out and up, slows, falls, and fades out.

Burst size
From 5 to 150, starting at 40. The number of emotes in a burst.
Size (px)
From 16 to 200, starting at 56. The height of an emote in a frame 1080 pixels high. It scales with the frame, and each emote is a little larger or smaller than the next.
Intensity
From 1 to 100, starting at 60. How hard the emotes are thrown, and so how far they spread.
Duration (seconds)
From 1 to 15, starting at 4. How long an emote lasts. It fades out over its last moments, and it leaves earlier if it has fallen out of the bottom of the frame first.

Landscape and portrait

The overlay fills whatever size you give the browser source. Sizes and distances follow the frame’s shorter side, so a 1920 by 1080 frame and a 1080 by 1920 frame show emotes of the same size thrown the same distance. The Landscape and Portrait buttons above the preview only change the shape of the preview, not the link.

Performance

At most 300 emotes fly at once; while that many are flying, new ones are left out, so a run of events never slows your stream. The frame loop stops while the source is hidden. A viewer whose device asks for less motion sees each emote appear where it would be a moment after leaving, stay there and fade out instead of flying.

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
ona comma list of follow, sub, gift, raidsub,gift,raid
keyyour Dual IRL alerts key, read from the # part onlynone
emoteschat, named or bothchat
namesup to 20 emote names, separated by commasnone
burst5 to 15040
size16 to 20056
intensity1 to 10060
duration1 to 15 seconds4
sample1 to burst built-in sample emotes every few seconds and read no chatoff