OverlayThing Docs
Home
Login / Request Access
01 Get started
Introduction Quickstart Add to your stream
02 Overlays
Overlays The editor Overlay URLs Alert queue Share, export & import
02.1 Widgets
Widgets overview Alerts Variations Hype Train Text to speech Live Captions Goals Countdown & subathon Chat box Data labels Counter Text, image & video
03 Chatbot
Chatbot overview Getting started Commands Variables Conditionals Recipes API commands Integrations Command API & Copy-URL Chat moderation Bot account Bot settings
03.1 Chatbot modules
Modules overview Timers Counters Quotes Chat alerts Welcome Ad Breaks Giveaways Queue Song requests Loyalty
04 Flows
Overview Build a flow Triggers Conditions Actions Using data Examples
05 Channel Rewards
Channel Rewards
06 Remote Control
Overview Connect OBS Studio Connect Meld Studio Bindings & triggers Security & access
07 OBS Dock
Overview & setup Layouts & display Chat & Needs You Activity & media Stream info & controls
08 Companion
Companion overview Install & pair Feed, chat & channel Live Captions Scripting The scripting API Permissions & security
09 Monetize
Tip page Tip settings Merch with Fourthwall
10 Build your own
Describe & Build Custom widgets Widget SDK
11 Your data
Dashboard Stream data Chat log Moderation
12 Account
Settings & connections Export your data Import from StreamElements
13 Reference
Label tokens Keyboard shortcuts FAQ Troubleshooting
Widgets/Live Captions
Widgets

Live Captions.

Put what you say on screen as you say it. The Companion listens to your microphone and the Live Captions widget shows the words on your overlay, word by word, in your fonts and colors, with lines that settle and roll away the way broadcast captions do.

How it works

Live Captions has two halves. The Companion on your streaming machine captures your microphone and turns speech into text. This widget is the other half: it sits on your overlay and paints that text as it arrives. Add the widget once; everything about when captions run (start, stop, mute, which microphone) lives in the Companion, and everything about how they look lives here.

You need the Companion

The widget shows nothing on its own. Install the Companion, open its Live Captions section, pick your microphone and press Start. Live Captions is enabled per account; if the Companion says it is not enabled for yours, get in touch and we will switch it on.

Add it to an overlay

1

Add the widget

In the editor, open the widget picker and choose Live Captions. Pick one of the templates (Broadcast, Boxed, Minimal, Neon, Retro, Cozy Serif, High Contrast and more) or start blank. It drops onto the canvas as a wide, short box.

2

Place and size the box

Captions wrap to the width of the box, so make it as wide as you want a line to run and tall enough for your line count. Most streamers park it along the bottom edge, above the chat or facecam.

3

Style it

Font, size, weight, color, outline, shadow and background are all yours. The preview shows a sample line so you can see the result without talking.

4

Start captioning

Open the Companion, press Start in Live Captions, and speak. Words appear on the overlay within a moment of you saying them.

Settings

Text

SettingWhat it does
Family, Size, Weight, ColorThe caption font. Any font available to your overlay, including the ones you already use elsewhere.
Letter caseNormal, or force everything to UPPER for a broadcast look.
AlignmentLeft, center or right within the box.
Letter spacing, Line heightFine tuning for readability. A little extra line height helps when you show three or more lines.

Outline and shadow

SettingWhat it does
Stroke color, Stroke widthAn outline behind each letter. Set the width to 0 to turn it off. With no background box, an outline is what keeps text readable over gameplay.
Shadow color, Blur, Offset X, Offset YA drop shadow. Blur and both offsets at 0 turns it off.

Background

SettingWhat it does
BackgroundNone for bare text, Solid for an opaque box, Semi for a translucent one. Solid and Semi reveal Fill color, Opacity, Padding and Radius.
Fill color, OpacityThe box color and how see-through it is.
Padding, RadiusSpace between the text and the box edge, and how rounded the corners are.

Layout

SettingWhat it does
AnchorBottom keeps the newest line at the bottom and pushes older lines up and off the top, like TV captions. Top does the reverse. Custom lets you pin the text block at an exact X and Y inside the widget.
Max widthHow much of the widget box the text may use, as a percentage. Lines wrap at this width.
Max linesHow many lines stay on screen. When a new line arrives and the limit is reached, the oldest rolls off. Two or three is the sweet spot; more than that gets hard to follow.
Max chars per lineA soft cap on line length, so a very wide box does not produce one endless line.

Reveal

SettingWhat it does
Reveal modeInterim shows words as they are spoken, with the lowest delay; the live word can still change slightly as it settles. Final only shows each line once it has settled: steadier and easier to read, at a slightly higher delay.
LingerHow long the last caption stays on screen after you stop talking, before it fades.
FadeHow long the fade-out takes once a caption is done.

What the words do on screen

Captions arrive one word at a time and the widget paces them so the line reads smoothly, even when you talk fast. Each new word fades in softly, a line that is still being spoken updates in place (so a half word becomes the whole word rather than jumping), and once a line is complete it stays put while the next one builds under it. If you pause, nothing is lost: the widget uses the quiet moment to catch up. If the browser source was asleep (hidden in OBS, or your machine slept), it skips what nobody watched and picks up at the live line instead of replaying a backlog.

Tips

  • Readable over anything: if you prefer no box, use a 2 to 3 px stroke and a soft shadow. If you use a box, Semi at around 50% opacity keeps the game visible behind it.
  • Two lines, left aligned is what viewers are used to from TV and the easiest to follow mid-stream.
  • Keep the font size honest: captions are read at a glance from the corner of the eye. Go larger than you think, then trim the max width.
  • Noisy room? Turn on noise suppression in the Companion rather than fighting it with the widget; see Live Captions in the Companion.
Captions are also saved

The Companion keeps a transcript of every session on your machine, with search, day by day history, and .txt / .srt export. See Live Captions in the Companion.

Related

  • Goals
  • Text to speech
  • Countdown & subathon
  • Hype Train
Previous Text to speech Next Goals
On this page
Ask the docs
Have a question?
Thinking it through...
Answer
Get an answer instantly; our model is trained on every feature of our streaming suite.
ESC
Get started
More than overlaysOverlayThing is an all-in-one toolkit for your Twitch channel: a visual overlay … Get started From zero to liveThe fastest path to a working overlay on your stream. Sign in, build something, … Get started Add to your streamOne overlay, one URL, one browser source. OverlayThing works with any streaming … Get started
Overlays
OverlaysYour overlays live on the Overlays page, a gallery of every canvas you have buil… Overlays The editorWhere overlays are built. A canvas in the middle, your layer stack on the left, … Overlays Overlay URLsEach overlay has its own private URL. Add it to your streaming software once and… Overlays Alert queueWhen events pile up (a gifted-sub train, a hype raid), you usually want alerts t… Overlays Share, export & importMove overlays and individual widgets between your own overlays, back them up as … Overlays
Widgets
Widgets overviewWidgets are the building blocks of an overlay. Some fire on an event and leave (… Widgets AlertsThe moment something happens, an alert fires on screen with motion, sound and yo… Widgets VariationsOne event, different reactions. Variations let a single alert play a bigger vers… Widgets Hype TrainWhen a Hype Train rolls on your channel, OverlayThing can fire an on-screen aler… Widgets Text to speechHave alerts read messages aloud: a tip note, a resub message, a redemption. Text… Widgets Live CaptionsPut what you say on screen as you say it. The Companion listens to your micropho… Widgets GoalsA progress bar with a target. It fills itself as events come in, and you can cel… Widgets Countdown & subathonTwo timer widgets. A countdown runs down to a time or for a set duration. A suba… Widgets Chat boxPut your Twitch chat on stream, great for handheld, IRL or face-cam layouts wher… Widgets Data labelsSmall live readouts that keep your channel numbers on screen: latest follower, l… Widgets CounterPut a live number on your overlay: deaths, wins, fails, anything you keep a runn… Widgets Text, image & videoThe plain building blocks. Use them for backgrounds, frames, logos, panels and l… Widgets
Chatbot
The chatbotA Twitch chat bot built into OverlayThing: custom commands, timers, counters, qu… Chatbot Getting startedTurn the bot on, make it a moderator, and pick your command prefix. Three small … Chatbot CommandsCommands are the heart of the bot. A viewer types a trigger, the bot replies wit… Chatbot VariablesVariables are $( … ) tokens you drop into a command response. They fill in with … Chatbot ConditionalsConditionals let one command react differently to different viewers and situatio… Chatbot RecipesCopy-ready command responses for the trickier variables: shoutouts, weather, dic… Chatbot API commandsPower-user territory. Wire a command to an external API and pull a live value in… Chatbot IntegrationsBuilt-in connections to outside services that add ready-made variables. Today th… Chatbot Command API & Copy-URLFire bot commands and module actions from outside chat: a Stream Deck button, a … Chatbot Chat moderationWhen the bot is a moderator it can keep chat clean automatically: tunable spam f… Chatbot Bot accountChoose which Twitch account the bot posts as: the shared OverlayThing bot, your … Chatbot Bot settingsThe channel-wide behavior of the bot: your prefix, how it replies, how cooldowns… Chatbot
Chatbot modules
ModulesThe bot is built from modules you switch on one at a time. Turn on only what you… Chatbot modules TimersPost recurring messages on a schedule: rules, your socials, a sponsor plug. Time… Chatbot modules CountersTrack a number from chat: deaths, wins, fails, anything you want to tally live.… Chatbot modules QuotesA searchable quote book your chat builds with you, one memorable line at a time.… Chatbot modules Chat alertsPost a chat message when someone follows, subscribes, resubs, gifts, cheers or r… Chatbot modules WelcomeGreet people automatically: first-time chatters, returning regulars, and incomin… Chatbot modules Ad BreaksHave the bot speak up around your ad breaks: a heads-up before they hit, a line … Chatbot modules GiveawaysRun a giveaway and draw a winner from chat, by keyword entry or passive presence… Chatbot modules QueueLet viewers line up to play with you. They join, you pull people up in order.… Chatbot modules Song requestsViewers request YouTube songs by name or link and the bot builds a play queue, w… Chatbot modules LoyaltyTrack how long your viewers watch, so you can spot and reward your most loyal re… Chatbot modules
Flows
FlowsFlows let you wire your channel together with no code. Pick something that happe… Flows Build a flowYou build a flow on a canvas: add nodes, connect them in the order they should r… Flows TriggersA trigger is the event that starts a flow. Every flow has at least one. Most tri… Flows ConditionsConditions are the rules in a flow. They decide whether the run keeps going and … Flows ActionsActions are the things a flow does. Most of what the rest of the platform can do… Flows Using dataThe best flows feel personal because they use the real details of the event. Dro… Flows ExamplesFour flows from simple to advanced, drawn as the real graphs you build on the ca… Flows
Channel Rewards
Channel RewardsCreate channel-point rewards through OverlayThing and your flows can do things T… Channel Rewards
Remote Control
Remote ControlDrive your local OBS Studio or Meld Studio straight from OverlayThing. Switch sc… Remote Control Connect OBS StudioAdd the Remote Control URL as a dock or browser source, enable the OBS WebSocket… Remote Control Connect Meld StudioAdd the blank Remote Control source to every Meld scene. There is no password to… Remote Control Bindings & triggersA binding is one or more actions plus the trigger that fires them. Build them on… Remote Control Security & accessThe Remote Control URL is a key to your streaming software, and your OBS passwor… Remote Control
OBS Dock
OBS DockChat, activity, media requests and stream controls in a panel docked inside OBS.… OBS Dock Layouts & displayBuild the dock out of panes, save arrangements as layouts, and open a second doc… OBS Dock Chat & Needs YouRead and send chat as yourself, moderate from the message row, and clear AutoMod… OBS Dock Activity & mediaEvery channel event in one filterable feed, and full control of the media queue … OBS Dock Stream info & controlsEdit your title, category and tags without leaving OBS, and run markers, clips, … OBS Dock
Companion
CompanionA native desktop app for macOS and Windows that pairs with your OverlayThing acc… Companion Install & pairDownload the Companion for your operating system, open it, and approve one short… Companion Feed, chat & channelThe Companion mirrors the parts of your dashboard you touch mid-stream, on your … Companion Live CaptionsCaption your stream from your own microphone. The Companion listens, turns your … Companion ScriptingWrite small scripts that react to your stream and do things only a local app can… Companion The scripting APIThe complete ot surface: every event you can listen to, every action you can tak… Companion Permissions & securityScripts run in a sandbox and start with zero powers. You grant each capability p… Companion
Monetize
Your tip pageA branded donation page viewers can reach from a single link in your panels or c… Monetize Tip settingsEverything behind your tip page: the payment connections, your branding, the amo… Monetize Merch with FourthwallConnect your Fourthwall shop and merch sales fire alerts on stream, the same way… Monetize
Build your own
Describe & BuildDescribe the widget you want in plain language and OverlayThing builds a styled,… Build your own Custom widgetsFor when you want to break the mold. Write your own HTML, CSS and JavaScript, re… Build your own Widget SDKThe API your custom widgets use to receive live events and persist state. It is … Build your own
Your data
DashboardYour home base. The numbers that matter at a glance, a chart to spot trends, and… Your data Stream dataThe numbers behind your overlay. Labels, goals and leaderboards all read from he… Your data Chat logA searchable archive of your chat, events and moderation actions. Look up what a… Your data ModerationEvery chat message, tip note and alert message runs through a moderation pipelin… Your data
Account
Settings & connectionsYour account, your connected services, and the controls that protect your access… Account Export your dataYour data is yours. From Settings, under Data and privacy, you can take it with … Account Import from StreamElementsAlready set up elsewhere? Bring your overlays, alert settings, goals and history… Account
Reference
Label tokensTokens are {placeholders} you drop into alert text, label templates and goal lab… Reference Keyboard shortcutsThe editor is built for the keyboard. These are the ones worth learning.… Reference FAQShort answers to the questions we hear most. For step-by-step fixes when somethi… Reference TroubleshootingQuick fixes for the things that trip people up most.… Reference
↑↓ navigate ⏎ open esc close