Help
How the Multichat chat app, the streamer setup and the OBS overlay work.
Chat app
Open the chat app on your phone or computer.
Add it to your home screen
On a phone, the app works best from the home screen: full screen, with its own icon.
- iPhone / iPad (Safari): open the app → the Share button (□↑) → Add to Home Screen → Add.
- Android (Chrome): open the app → ⋮ (top right) → Add to home screen or Install app → Install.
- Samsung Internet: open the app → ☰ (bottom right) → Add page to → Home screen.
- Computer (Chrome / Edge): the install icon at the right of the address bar, or ⋮ → Cast, save and share → Install page as app. There's also a desktop app.
Channels
The name at the top is the channel you're in. Tap it to switch, to add a channel, or ✎ to edit one. A channel is one streamer: a name of your choice, and their channel on each platform they stream on (Twitch, TikTok, Kick, YouTube). Their chats show together. Drag a channel by its grip (⠿) to change the order of the list.
In the channel list, each channel can show:
- Live - one of its streams is live
- @ - someone mentioned you there
- - new messages you haven't seen
When another channel has something new, a blinking dot shows next to the name at the top. The @ and new-message dots can be switched off per channel in its editor.
The pill at the top left shows the connection - and Live · viewers while a Twitch stream is on. Tap it for the stream's title, category and uptime. The screen button next to the menu opens the stream player.
Chatting
Log in with Twitch (☰ → Twitch account) to chat. Type / for Twitch's commands, /poll and /prediction open those tools (moderators), :name or Tab completes emotes, @ completes names, and ↑ brings back your last message. Tap a message to reply, copy it, see what that person said before, or (moderators) remove it.
Chat settings (☰ → Chat)
- Font size, Badges, Platform icons (Automatic: only while streams on more than one platform are live), Timestamps, Highlight mentions of me, Message box and the Background colour.
- Stream together - when channels stream together and share their chat, the partner channels' messages show with the partner's picture as their first badge. You can hide those messages, or their moderator/VIP, sub or other badges.
- Announcements - the lines for subs, raids, follows, gifted subs, channel point rewards, polls, hype trains and more. Switch them all off, or kind by kind.
- Hidden words - messages with a word or phrase you add are left out of the chat - or, with Shown as ***, shown with just the word covered. Whole words, any case; * stands for the rest of a word (spoil* also hides spoiler and spoilers). Your own messages always show.
- Read messages aloud - new messages are spoken as "Name: message", one after another, in the voice (language) of your choice. Emotes and links are skipped. Besides your device's own voices there are built-in English, Chinese, French, German and Norwegian voices that are always there, whatever languages your phone has.
- On phones and tablets: Keep screen awake, and on phones Lock upright.
Alert sounds (☰ → Alert sounds, on phones and tablets)
Paste the alert box URL you'd give OBS (e.g. a StreamElements or Streamlabs alert box) to hear the stream's alerts in the app. They only play while the app is open on screen, and the URL stays on your device. With Pause reading aloud, messages read aloud stop while an alert plays and pick up where they stopped.
Moderating
In channels you moderate (or own), ☰ → Moderation has the chat modes, Clear chat, polls and predictions. Messages removed by any moderator stay visible to you, greyed out and labelled.
Mod actions in chat
- Off - tap a message for delete, timeout, ban and pin.
- Buttons - delete, timeout (10 minutes) and ban buttons at the start of each message.
- Slider - a strip down the left edge of each message. Slide it right and let go:
The message shows what letting go would do while you slide.Slid to Does under 20% nothing (let go to cancel) 20-30% deletes the message 30-80% times the user out: 1 minute, 10 minutes, 1 hour, 24 hours or 7 days (every 10%) 80-100% bans the user
Banned and timed-out users' messages get an Unban button.
Messages AutoMod holds back show up for you with Allow / Deny.
Activity (StreamElements)
Where the streamer has added StreamElements, ☰ → Activity lists the last 24 hours of follows, subs, cheers, tips, raids and redemptions. Replay plays a missed alert again on stream; Pause alerts, Mute and Skip alert control the alerts on stream. The streamer decides which of these moderators may use.
If the streamer hasn't set up their channel, the Moderation section says what's missing - copy the setup link for them.
For streamers
On the streamer setup page, sign in with Twitch to authorize Multichat for your channel. Then:
- your moderators can run polls and predictions from the app,
/modsand/vipswork in the app's message box (Twitch only gives those lists to your own login), and signed in to the app as yourself you can/mod,/unmod,/vip,/unvip,/raidand/unraidin your own channel,- channel-point redeems, follows, shoutouts, hype trains, power-ups and the pinned message show in the app and overlays,
- your channel stays connected, and its chat is kept on the server for a day - so moderators can look up what someone said.
Add your StreamElements JWT token there too for the alert history, replays and alert controls in the app - and choose whether your moderators may pause, mute and skip alerts, and replay them any time, once per alert, or not at all. The token stays on the server.
OBS overlay
Build a URL on the overlay page - its preview shows made-up chat with your options - and add it to OBS as a Browser Source (e.g. 420 × 600). Turn off "Refresh browser when scene becomes active" and leave "Shutdown source when not visible" unchecked. The overlay updates itself when the server is updated.
Saved overlays: sign in on the overlay page with Twitch or Discord (only your name - no permissions) to keep your overlays there, as many as you like. Each one has a short address for OBS (/?overlay=…); its settings stay on the server, and what you save shows in OBS straight away - no need to refresh the browser source. Anyone with the address sees that overlay, so treat it like the overlay itself. Deleting an overlay makes OBS show a short note instead of chat. Twitch and Discord sign-ins are separate accounts, each with its own overlays.
Sharing: the owner of a saved overlay can let others edit it - Invite editor under Sharing makes a link that works once, for 48 hours. Whoever opens it and signs in (Twitch or Discord) can change the overlay's options and name; only the owner can delete it, invite people or remove them. If two people change the same overlay, the second to save is asked whether to keep theirs or load the other person's version, and the page picks up other people's saves by itself.
On the page you also choose the position (top or bottom, left or right), the message box (colour, transparency, an outline) and each announcement kind's colour and emote - an emoji, one of the channel's emotes (Twitch, 7TV, BTTV, FFZ), or none in place of the emoji the line starts with.
The page offers the common options; the ones below it doesn't (outline, showAvatar, debug, ...) can be added to the URL by hand - also after a saved overlay's address (/?overlay=…&showAvatar=1).
What the URL can say:
| Option | Default | What |
|---|---|---|
twitch, youtube, kick, tiktok | none | Channels, comma separated |
ignore | none | Chatters to leave out, e.g. nightbot,streamelements |
hideWords | none | Words or phrases whose messages are left out, e.g. spoiler,spoil* - whole words, any case, * for the rest of a word |
maskWords | 0 | 1 shows those messages with the words covered (***) instead |
max | 40 | Messages kept on screen |
fontSize | 20px | Text size |
fontFamily | Inter | Any CSS font |
fade | 0 | Seconds before a message fades out (0 = never) |
align | bottom-left | Where the chat sits: bottom-left, bottom-right (bottom: grows upward), top-left or top-right (top: starts at the top and grows downward; once full, new messages come in at the bottom like the others). On the right the message boxes keep to the right edge (their text still reads from the left). (bottom / top = on the left.) |
showBadges | 1 | Chat badges |
showEvents | 1 | Announcements: sub, raid, gift, follow and other lines. 0 leaves them all out |
hideEvents | none | Announcement kinds to leave out, comma separated: follows, subs, gifts, raids, rewards, cheers, polls, hypetrains, shoutouts, streaks, emotes (shoutouts and emote changes show only in the app, and hype trains as the app's bar above the chat - the overlay never has lines for them) |
showPlatformIcon | auto | Platform icon: auto (while more than one platform is live), always, 0 |
showChannel | 0 | #channel tag on each message |
showAvatar | 0 | TikTok profile pictures |
outline | 1 | Text outline |
box | 1 | Dark box behind each message |
boxColor | 000000 | The box's colour (hex, no #) |
boxPadding | 0.15em / 0.4em | Room between the text and the box's edge, in px - the same on all four sides (by default a little above and below, more at the sides) |
boxOpacity | 35 | How solid the box is, 0-100 (100 = not see-through) |
boxOutline, boxOutlineWidth, boxOutlineOpacity | none, 2, 100 | An outline around the boxes: its colour (hex, no #), width in px, and how solid it is (0-100) |
eventStyles | none | Announcement colours and emotes per kind (or all), as JSON: {"subs":{"c":"e63946","e":"⭐"},"follows":{"e":""}} - c colour, e emoji (empty = none), i + n an emote picture's address and name. Easier on the overlay page |
textColor | white | Hex colour (no #) for the text |
shared | 1 | Stream together: 0 hides the partner channels' messages |
sharedRoles, sharedSubs, sharedGlobal | 1 | 0 hides the partners' chatters' moderator/VIP, sub or other badges |
twemoji | in OBS | Emoji as images |
debug | 0 | Connection dot |