# Creator Kit — full stream overlay

One StreamElements widget that gives you the whole overlay:

- **Subscriber goal** — "742 / 1,000" with a progress bar, filled automatically
- **Donation goal** — the same bar for money, with your own title and target
- **Voice** — super chats and donations read out loud, with your own limits
- **Cards** — latest subscriber, latest member, latest super chat, latest donation
- **Your info** — creator code and player ID
- **Game frame** — angled corner brackets around your gameplay (or none at all)
- **Chat window** — your live chat in the same style
- **Alerts** — a big pop-up in the middle of the screen when someone subscribes, becomes a member
  or tips, plus a particle burst and a flash on the game frame

Everything is changed from the settings panel inside StreamElements. You never touch code.

> **This is not an import.** StreamElements' "Import" page (Streamlabs, Nightbot, ...) is a different
> thing. You paste four files into a *custom widget*, as described below.

## Install (once, about 5 minutes)

1. Unzip `creator-kit-streamelements.zip` (right click → Extract all). You get `widget.html`, `widget.css`,
   `widget.js` and `fields.json`.
2. Open StreamElements → **Streaming tools → My Overlays** → **New overlay**, 1920 × 1080.
3. Click **+** (add widget) → **Static / Custom → Custom widget**.
4. Select the new widget and click **Open editor** in the left panel.
5. The editor has tabs. For each tab, click into the code box, select all (Ctrl+A), delete, then paste
   the matching file (open each file in Notepad, Ctrl+A, Ctrl+C):

   | Tab    | File          |
   | ------ | ------------- |
   | HTML   | `widget.html` |
   | CSS    | `widget.css`  |
   | JS     | `widget.js`   |
   | FIELDS | `fields.json` |

   Leave the DATA tab alone.
6. Click **Done**.
7. **Important:** make the widget cover the whole canvas. With the widget selected, set
   position **X 0, Y 0** and size **W 1920, H 1080**. The overlay positions itself from its own
   settings, so if the box is smaller, the frame, the pop-up and the particles get cut off.
8. Click **Save** (top right).
9. Copy the overlay link (chain icon, top right) and add it in OBS as a **Browser source**,
   1920 × 1080. Put that source **above** your game capture.

## The settings

Click the widget in StreamElements. The left panel has these sections:

- **1 · Your info** — creator code and player ID. Leave a field empty and its card disappears,
  so leave the creator code empty until you have one, then type it in. "One card that switches"
  saves space.
- **2 · Cards** — which cards to show, which side they sit on, how far from the top.
- **3 · Goal** and **4 · Donation goal** — see below.
- **5 · Game frame** — the frame around your gameplay. It sits **inside** your capture area, so at
  100 % height it uses the whole screen. Untick **Show the frame** to get rid of the corner
  marks completely, and empty the **Text under the frame** field to remove the label — handy
  when you use the overlay for other games.
- **6 · Chat** — side, width, how many messages to keep. New messages appear at the bottom and
  push older ones up. The chat grows from the bottom, so an empty chat is not a big dark box.
  **Names in their own column** lines every name up at the same place, so you can scan who wrote
  what instead of hunting for the name in the middle of the text. The column width is yours to set.
  **Badges** greet people: "first time here" on a newcomer's first message, "regular · 12 streams"
  once someone has chatted on enough days (you pick how many, and both texts). See **Chat badges** below.
- **7 · Look** — **color presets** (Imperial Red, Neon Blue, Tower Gold, Terminal Green) or your
  own colors, plus font, size and distance from the screen edge. See **Reading it on a phone** below.
- **8 · Alerts** — the big pop-up (on/off, how long, where, how big), the **alert sound** (on/off,
  volume, or your own sound file), how many particles, and
  **test buttons** for every animation including the chat, so you can see it all without waiting
  for a real event.
- **9 · Voice** — reading messages out loud, see below.
- **10 · Texts** — every word on the cards and pop-ups.

Press **Save** after changing something. OBS picks it up by itself; if not, right-click the browser
source → **Refresh**.

To use your own colors, set **Color preset** to "Custom" first — otherwise the preset wins.

## Chat badges

A small badge in front of someone's first message of the stream: **first time here** for a
newcomer, **regular · N streams** for people who keep coming back. It helps you say hello to the
right people.

- **What is kept:** for each person who writes in your chat, the last day they wrote and on how
  many days they have written. Nothing else: no messages, no other channels, nothing that leaves
  your own StreamElements account. A day with at least one message counts as one stream.
- **Who:** people are told apart by their YouTube channel id (or Twitch id), so a name change
  does not make a regular a newcomer.
- **How many:** up to 3,000 people; the ones who have not written for the longest time are forgotten
  first.
- **Forget everyone:** **6 · Chat → Forget all chatters**. If the overlay is open in OBS at the same
  time, right-click the browser source there → **Refresh**, so it does not write its old counts back.
- **Turn it off:** untick **Badges for first-time chatters and regulars**. Nothing is counted then.
- The **Test chat message** button shows badges but never counts.

## The two goals

**Subscriber goal.** Set your target under **Goal** and you are done. StreamElements already
knows your real subscriber count and the overlay reads it from there — no key, no handle,
nothing to sign up for. It follows the real number, so it also goes down if someone unsubscribes.

If the card shows a dash ("— / 1,000"), StreamElements has not sent the number yet. Give it a
moment; if it stays that way, switch **Where the subscriber number comes from** to "I type it in
myself", type your count, and the overlay counts up from there on every new subscriber.

**Donation goal.** Under **Donation goal**: your own title, the amount, and whether it counts
donations from this stream, this week, this month or all time. Super chats count towards it as
well unless you untick that. The currency sign is yours to set (it starts as €).

The donation goal has **its own size**, separate from the cards: **Donation goal size** (starts at
130 %) and **Size of the two lines under it** (also 130 %, on top of the goal's size). With your
game in the middle, about 140 % is the most that fits before the goal touches the game frame.
If you put the goal "In line with the other cards", it takes the normal **Card size** instead.

Both bars flash briefly when they move, and there is a small fanfare when a goal is reached.
The test buttons move the bar on screen only; nothing is saved.

## Reading messages out loud

Under **Voice**. StreamElements does the speaking, so there is nothing to sign up for and no
second account — the overlay already has what it needs.

Everything is yours to set:

- **Read messages from** — super chats and donations, or members too, or everything.
- **Only from this amount up** — starts at 2. This is the setting that matters most: it decides
  how cheap it is for someone to put words on your stream. Raise it if people start playing games.
- **Voice** — 11 picked ones in the list (Brian is the default, the classic stream voice). Want a
  different one? StreamElements has over 200; type its name into the field below the list and it
  wins over the list.
- **Volume**, **say the name first**, and **how many characters** before it stops reading.

What it reads is the viewer's own message, never the event itself — the pop-up and the sound
already say that someone subscribed. No message means nothing to read.

Before anything is spoken it goes through **your own StreamElements word filter** (the one in your
tipping settings), links are replaced by the word "link", and held-down keys like "aaaaaaaaaa" are
shortened. If the filter cannot be reached, nothing is read out rather than something unchecked.

It plays through the same OBS browser source as the alert sounds, so the same tick applies:
browser source properties → **Control audio via OBS**.

## The two text lines

Under **Text lines** you get two free lines that sit under the donation goal — one for what the
money is for, one for how to donate (for example `!tip €2 for TTS`), plus their own size.

**They do not depend on the donation goal.** Switch the goal off and the lines stay where they
are, so a line like "!tip €2 for TTS" can be up all the time while the goal only appears when
you actually have one running. Leave a line empty and it disappears.

Both the goal and the lines sit wherever **Where the donation goal and the text lines sit** says
(any of the four corners, or in line with the other cards).

## Moving blocks around

Three things can sit where you want them, each with its own size:

- **Creator code + player ID** — under **Your info**
- **Donation goal + the text lines** — under **Donation goal**
- **Cards and chat** — left or right, under **Cards** and **Chat**

Each takes one of the four corners, or stays in line with the other cards. **Do not put two of
them in the same corner**, they would sit on top of each other. Nothing stops you, so just pick
different ones.

## Full-screen scenes

Under **Scene** the whole overlay turns into one big screen instead: **Stream is starting**,
**Stream is ending**, or **Thanks for watching**. Pick the mode and it is done - the texts fit
the scene on their own, and you only type something if you want your own wording.

What you can put on it:

- **A picture on top** - your logo or a mascot. Click the field under Scene and the
  StreamElements media library opens, where you can upload your own file or pick one you already
  have. Set its height with the slider. Leave it empty and the scene just starts with the
  headline.
- **A background picture** filling the whole screen, from the same library. Next to it is a
  **darken** slider, and you will want it: over a busy picture the headline stops being readable.
  55 percent is a good starting point.
- **A countdown** in minutes for the starting and ending scenes. It is a ring that empties, so
  people read the remaining time at a glance instead of squinting at digits. In the last ten
  seconds it switches to your second colour and beats, and at zero the ring disappears and your
  own text takes its place. It starts counting the moment the scene loads, which in OBS is when
  you switch to it.
- **Your links** at the bottom left, typed separated by commas, and your **creator code** at the
  bottom right.
- **Corner marks** around the screen, the same ones that frame your gameplay.

When you switch to a scene, the parts arrive one after another instead of all at once, and a
light drifts slowly along the top and bottom edge. That is kept slow on purpose: people stare at
a "starting soon" screen for minutes, and busy motion gets annoying fast. **Motion: Calm** under
Alerts switches all of it off.

Alerts still pop up on top of a scene, so someone subscribing during "starting soon" still gets
their moment.

**The easy way: the scene maker.** The three scenes also exist as files of their own that need
nothing from StreamElements, so there is no overlay to duplicate. On the overlay kit page you type
your links, creator code and countdown, add your logo and background, look at the result, and
download all three as one zip:

1. Unzip it somewhere you will find it again. Your pictures sit next to the scene files; keep them
   together in that folder.
2. In OBS, in your "Starting Soon" scene: **+ -> Browser -> tick "Local file" -> pick the file**,
   and set the size to **1920 x 1080**.
3. Want to change a word later? Open the file in Notepad. The settings are at the very top, in
   plain words. Change what you like, save, then right-click the source in OBS -> **Refresh**.

One file per OBS scene, and switching scene in OBS is all you do.

**The other way: inside StreamElements.** You can also set **Scene** in the widget settings. Then
be aware of two things: one StreamElements overlay is one link, so every OBS browser source using
that link changes at once - make a **duplicate** of the overlay per scene. And a settings change
does not always reach a browser source that is already open: right-click it in OBS and choose
**Refresh**.

**The "Thanks for watching" one is for the end of a video**, not for the stream. The two
rectangles and the circle are **empty frames on purpose**: YouTube draws its own clickable
elements there, and you place those in YouTube Studio under End screen. They only work in the
**last 5 to 20 seconds** of a video, so the graphic has to run that long. If you would rather
place them elsewhere, untick **show the YouTube end-screen frames**.

## Good to know

- Names, amounts and chat come straight from your StreamElements account. Nothing else is
  connected: no extra accounts, no other website, no keys.
- **The chat only works if your YouTube chat is connected to StreamElements.** If messages do not
  show up, check that first — the overlay cannot reach YouTube by itself.
- Super chats and donations: the pop-up shows the viewer's message (you can turn that off).
  Normal emoji work. Custom channel emotes show up as text like `:name:`, not as pictures — this
  applies to the chat window as well.
- **Sound:** every alert plays a built-in sound (a different one for subscriber, member and
  money, and a fanfare when the goal is reached). Set the volume, turn it off, or upload your
  own sound under Alerts. **In OBS, open the browser source's properties and tick
  "Control audio via OBS"**, otherwise the sound may not reach your stream. Then the overlay
  shows up as its own channel in the OBS audio mixer and you can set its level there. Inside the
  StreamElements editor preview the browser usually blocks sound, so check it in OBS.
- Messages starting with `!` are hidden in the chat by default (bot commands).
- If several events arrive at once, they play one after another.
- **Motion: Calm** switches off particles and movement if it ever feels like too much.
