The guide

Everything about YappyChat

Set it up, learn your way around, and get the most out of it. The guide follows the order you will meet things: set up, chat, moderate, stream, make it yours, then lock it down. Every picture is a real screenshot of the app, with sample chat.

New in 0.13.
  • Perks have a real checkout: sign in with Twitch on the website and pay by card, Apple Pay, Google Pay or PayPal. The heart button in the app opens the shop already signed in. Tips no longer come with perks.
  • Fewer permissions at login. Tick I only chat and don't moderate on the login screen to skip the moderator permissions. Extra tools still ask for their one permission when you open them, and Settings > About can drop every optional one.
  • Keyboard moderation: Alt+Up selects the newest message, Alt+Up/Down move, then D delete, T time out, B ban, W warn, R reply, Enter opens the card, Escape goes back to typing.
  • Your login is checked every hour (Twitch requires this). If Twitch says it is no longer valid, YappyChat logs you out instead of failing quietly. Starting without internet keeps your login and retries.
  • Diagnostics and crash reports: Settings > Account shows the local diagnostics log (tokens removed) and lets you switch crash reports off.
Earlier updates

0.12.2.

  • Chats snap around the stream from any side, even when only one chat is open.
  • Choose any split layout from the grid button in a chat's header, including one big chat with four small ones. Drag chats to reorder them.
  • Yappy lives beside the Chat button, as tall as the button. Drag him out and the message bar takes the full width.
  • A message box in every chat: Settings > Chat > Message box in every chat. The main bar stays.
  • GIFs, pinned messages and drops show in chat, each with a dismiss button and a switch in Settings > Chat. Paid (Hype Chat) pins show as they arrive. As a moderator you also see messages pinned by other moderators, checked every 45 seconds. Drops notices use the optional user:read:chat permission, which Settings > Security can ask for.
  • The Community panel has an arrow button to move it above, below, left or right of the chat.
  • Click an activity icon again to fold the panel away.
  • Everything sits above the stream window except the chats themselves.

0.12.1. Each holiday has its own entrance (snow, bats, a running turkey, flying eggs, a jet with red, white and blue trails, hearts and fireworks) and its own animated Yappy skin. The message box reads Send message in and the channel name. Suggest a feature now reaches the developer directly. Animated Twitch emotes move in chat. Settings has fewer sections: Filters (AutoMod display, cover words, ban list), Saved messages (macros and greetings), Announcements under Moderation and Logs under Chat, and AutoMod settings and blocked terms share one Chat filters window. In 0.12.0: Streaming together is shown automatically, entrances are visible to everyone and there are eight new name effects, Settings and the emote lists open over the stream window, emote suggestions can be switched off, Yappy activity links open the channel, and there is a Whisper button, per-channel mute and saved layouts. Anonymous usage statistics are described in the privacy policy. In 0.11.0: Only the chats you have open notify, sound and log (switch to All tabs in Settings > Chat), the Community pane resizes by dragging its edge (double-click resets), tabs and chat headers snap beside, above or over each other, typing letters completes chatter names, alert sounds never overlap and have a cooldown, Yappy activity can be dismissed, and Ctrl+1 to 9, Ctrl+Tab, middle-click and Ctrl+Shift+T switch, close and reopen tabs. In 0.10.1: The Community list now splits your chat instead of floating, tools can snap above the activity panel, streamer-only tools are hidden from mods, and the player's Clip button opens Twitch's clip page. In 0.10.0: A Community list that shows everyone in chat (not only people who spoke) and refreshes every 15 seconds, up to four streams at once, AutoMod and Mod actions that follow the chat you are in, and a perks cart whose prices are fixed by the server and whose tips are checked automatically. Also in 0.9.0: Polls, predictions and a user list, a streamer dashboard, /alert from your mods, /search, conversation view, undo in the mod feed, a one-click greeting for first-timers, the pencil to edit the title and game, an icon-only activity rail, a single Themes menu with Autumn, Winter, Summer, Spring and Minimal, up to six chats in split view, I'm not a Moderator, a passcode lock and start with Windows. Each one is covered in its own section below.

1. Getting started

The first time you open YappyChat, a short tour walks through the main parts of the window. Replay it any time from Settings > About or the command palette.

The welcome tour: a short animated preview, then a plain explanation of each part.
The welcome tour: a short animated preview, then a plain explanation of each part.

YappyChat talks to Twitch using your own Twitch developer application. You create it once, which takes a couple of minutes, and it keeps you in control of what the app can do.

  1. Install YappyChat. Download it from the download page and run the installer. If Windows says "Windows protected your PC", click More info then Run anyway: that warning appears for new apps that aren't yet widely downloaded. It updates itself in the background after that.
  2. Create a Twitch application. Go to dev.twitch.tv/console, choose Register Your Application, give it any name, set the OAuth redirect URL to http://localhost:3000, pick the category Chat Bot or Other, and create it.
  3. Copy the Client ID. Open the app you just made and copy its Client ID. The Client ID is not a secret password, but YappyChat hides it by default anyway; tick the eye button to show it.
  4. Paste it into YappyChat and press Continue with Twitch. You only do this once.

Logging in and permissions

Press Continue with Twitch and approve the permissions. One login covers chat and the stream window, so you never sign in twice.

The full list, with a plain reason for each and whether it is granted, is in Settings > About.

You may be asked to log in again after an update. When a version needs a new permission, Twitch has to approve it before that feature can work. Settings > Security lists every permission and whether it is granted.

Your login token is stored encrypted on your computer using Windows' own protection, and is removed (and, by default, revoked with Twitch) when you log out. See Security.

Adding and arranging channels

Press + next to the tabs. Type a name, paste a Twitch link, or add several at once separated by commas, like shroud, xqc, pokimane. You can have up to 50 channels open.

The tab bar: a purple line marks a Twitch channel, a red dot means live, and the second tab is flashing because something there needs you.
The tab bar: a purple line marks a Twitch channel, a red dot means live, and the second tab is flashing because something there needs you.

Moving tabs around

Drag a tab to reorder it. While you drag, a bright separator line shows exactly where the tab will land, between two tabs, so it is clear you are moving it between things and not onto one.

Dragging a tab: a bright line between two tabs shows where it will drop.
Dragging a tab: a bright line between two tabs shows where it will drop.

Tab colours and sounds

Right-click a channel tab to give it a colour and its own notification sound. The colour is used for the channel's name in its tab, in the channel bar and in split-view headers, for the ring around the streamer's picture, and for the border on mentions in that chat. It is saved on your computer only.

Right-click a tab: pick a colour, choose a sound for that channel, and list who you are streaming together with.
Right-click a tab: pick a colour, choose a sound for that channel, and list who you are streaming together with.

Split view

The grid button shows up to six panes at once. Chats and streams share those six: five chats when one stream is snapped beside them (a floating stream does not count), or fewer chats if you add more streams (see Stream window). One to three sit in a row, four make a 2×2, and five or six use three columns, with an odd one out stretching across the row. Drag a pane's header to reorder it and its edge to resize.

Split view: three chats side by side, with the activity rail on the right.
Split view: three chats side by side, with the activity rail on the right.
Split view with six chats in a grid of three columns and two rows.
Six chats: three columns by two rows. With five, the last one stretches across the row.

Any layout you like. The grid button in a chat's header lists the layouts for the number of chats you have open: Automatic grid, Side by side, Stacked, and One big on the left, right, top or bottom, so five chats can be one big and four small. Drag a chat by its grip (⋮⋮) onto another to swap or place it, or choose Make [channel] the big one from that menu. If you want a message box in every chat instead of one shared bar, turn on Settings > Chat > Message box in every chat; the main bar, where Yappy lives, stays.

The channel bar

Under the tabs, the bar shows who you are watching and how the stream is doing.

The channel bar: name, LIVE badge, title and game with a pencil, then Viewers, Time live and Session Information.
The channel bar. Row one: the streamer, a LIVE badge, the stream title and game, and (in channels you moderate) a pencil. Row two: viewers, time live and Session Information.

Streaming together and shared chat

Twitch starts a shared chat session when streamers use Stream Together, and everyone's messages appear in all of those chats. YappyChat shows this the way Twitch does:

Shared chat: the bar names the other streamers, and messages from their chats carry their picture.
Shared chat: the bar names the other streamers, and messages from their chats carry their picture.
This is read from Twitch automatically. Twitch's Guest Star guests are added too when the optional permission is granted. Nothing needs to be typed in.

2. Sending messages

Type in the box at the bottom and press Enter. The box understands a few shortcuts:

Replying to a message
The reply bar floats over the chat, above the message box.

Commands: /search and /alert

The message box takes Twitch's usual commands (/ban, /timeout, /unban, /warn, /clear and so on) plus two of YappyChat's own.

/search

Searches the messages YappyChat has seen in the chat you are in, and opens the results in a small window. Click a result to jump to it in the chat.

TypeFinds
/search clipMessages containing "clip".
/search @catEverything cat said (and from:cat works too).
/search @cat clipMessages from cat containing "clip".
/search "exact phrase"The words in that order.
The /search window with matching words highlighted.
/search lists matches with the words highlighted. Also search saved logs goes back through older days.

To search every open chat at once, press Ctrl+Shift+F. Ctrl+F searches the chat you are in.

/alert

For moderators: /alert chat wants you to check the game audio sends a message to the streamer that takes over their screen. See Alerts from your mods.

Emotes

The emote picker, grouped by channel, with a search box. Twitch, 7TV, BetterTTV and FrankerFaceZ all show up.
The emote picker, grouped by channel, with a search box. Twitch, 7TV, BetterTTV and FrankerFaceZ all show up.

YappyChat loads Twitch, 7TV, BetterTTV and FrankerFaceZ emotes for each open channel, and refreshes them when you switch to a chat and every few minutes. In the picker, My emotes is grouped by channel like Twitch's own picker, and emotes you cannot use in that channel are dimmed. Twitch emotes that anyone uses in chat always appear. If emotes look wrong, Settings > Emotes shows what loaded and lets you reload and test them.

Macros

The bolt button next to the message box lists your saved messages. Pick one to fill the box, or send it straight away if you ticked Send. {channel} and {me} are filled in.

Point at a message: delete, timeout, ban and warn on the left; reply, pin, save as macro and copy on the right.
Point at a message: delete, timeout, ban and warn on the left; reply, pin, save as macro (the bolt) and copy on the right.

Recent messages

When you open a chat, YappyChat fills it with the latest messages (50 to 500, your choice) so it is never blank, even when the stream is offline. They appear slightly faded above a divider; live chat continues below it. They do not trigger sounds or mentions.

Recent messages come from a public recent-messages service, which receives the channel name you open. The first time anyone opens a channel it may have nothing stored yet. Turn it off in Settings > Chat.

Whispers

Whispers sent to you appear in the Whispers tab of the activity rail, and Yappy tells you when one arrives. Reply right there.

Twitch only lets an account send whispers if it has a verified phone number, and may limit whispers to people you have not whispered before. Receiving needs the whisper permissions, so log in again after updating.

3. Message buttons

You must be a moderator (or the broadcaster) in a channel for these to work there. If you are not a moderator anywhere, I'm not a Moderator hides all of this.

ToolHow
Delete, timeout, ban, warnThe icons beside each message (always visible, hover-only, or hidden in Settings > Chat). The timeout length is set in Settings > Moderation.
Hover hotkeysWith hover hotkeys on, point at a message and press D, T, B or W.
Reply, pin, save as macro, copyA small toolbar when you hover a message. Pinning uses Twitch's /pin command and depends on what Twitch allows.
WarningsChoose a preset or write a reason; Twitch shows it to the chatter.

User cards

A user card: account age, quick moderation, a private note and a timeline.
A user card: account age, quick moderation, a private note and a timeline.

Click a name to see account age, follow date (when Twitch lets you see it), recent messages, private notes and a watch-list button. Under the notes is a timeline of their messages this session plus every moderation event for them across all your channels: bans, timeouts, deletes, warnings, AutoMod holds and unban requests. Ban everywhere bans them in all your channels where you moderate. Notes and the watch list are stored only on your computer.

Conversations

When two people reply to each other, the reply line shows "3 messages between them" (the count grows as they carry on). Click it to open the whole back-and-forth in one window, both sides' messages in order, so you can see who started it and who is escalating before you decide anything.

The conversation window: four messages between two chatters, replies marked with an arrow.
The conversation window. Click either name to open their user card. Copy puts the exchange on your clipboard, handy for a report.

It follows replies and @mentions of each other while YappyChat has been open, and it only appears once two people have actually answered each other.

The activity rail

Open the activity panel with the bell. Its tabs sit in a slim icon rail on the right edge; the section you chose fills the space beside it, with its name at the top. Click the open icon again to fold the panel away, so only the rail shows, and click any icon to bring it back.

The activity panel on the AutoMod section, with a tooltip on a rail icon.
Icons only. Hover one for its name; the red badge is how many are waiting.
The same panel with names shown beside each icon.
With names shown, the labels appear to the left of the icons. The panel keeps its width.
TabWhat it shows
MentionsMessages that mention you, match a highlight, or come from someone on your watch list. Click one to jump to its channel.
AutoModMessages held by AutoMod, with Allow and Deny. Live while YappyChat is open.
UnbansPending unban requests for the chat you are in, newest first. Type a name in the search box to find one. The list is checked with Twitch each time you open it, switch chat or restart, and the circular arrow checks again straight away. Approve or Deny from here.
FirstsPeople sending their first message in a channel, with greet, delete, timeout and watch buttons. Entries disappear after 2 minutes so the list stays short in big channels.
Joins / partsWho joined and left the chats on screen, checked every minute. They are still saved in the logs. Twitch may not report these in very large channels. Switch it off in Settings > Chat.
WhispersWhispers sent to you, with a reply box.
LinksLinks and clips posted by viewers (not moderators or VIPs) in channels you moderate. Open, delete the message, time the sender out, mark it fine, or allow the whole site. Turn it off in Settings > Moderation.
YappyEvery notification in one place, with the time: things Yappy said, who went live, mentions and alerts. Clicking Yappy opens this tab.
Mod actionsBans, timeouts, deletes and chat changes in channels you moderate, with who did each one, and an undo button.

Mod actions and undo

The Mod actions tab lists what happened in the chat you are looking at, straight from Twitch's moderation feed. Switch chat and the list switches with it (the weekly totals are kept per channel too). Each card shows the kind of action, the channel, the time and who did it. Columns and counts line up, in the feed and in the weekly table.

The mod actions feed: a ban and a timeout, each with an undo button on the right.
Each ban and timeout has an undo button on the right of its card.

Firsts and greetings

The hand button on a first-time chatter sends them a greeting as a reply to their message. Click it and pick one of your saved greetings, or Surprise me for a random one. Once greeted, the hand stays lit so the next moderator knows.

The Firsts tab: a first-time chatter with a greet button, and the list of saved greetings open.
Greet a first-timer in one click with a greeting you saved earlier.

Write your greetings, one per line, in Settings > Saved messages > Greetings. {user} becomes their name and {channel} the channel.

AutoMod

The AutoMod tab shows the messages held in the chat you are in, so a busy second channel never mixes into the first. Switch chat to review the other one.

A held message in the chat, with the flagged word marked and Allow and Deny buttons.
A held message in the chat, with the flagged word marked and Allow and Deny buttons.

If you moderate a channel, messages held by AutoMod appear in the chat with Allow and Deny and the flagged words marked, like Twitch's own mod view. If another moderator deals with it first, the line updates. In Settings > Moderation you can keep AutoMod, baseline or blocked-term holds out of the chat so they only show in the AutoMod tab. The AutoMod levels themselves can be changed from the more tools menu.

Polls, predictions, Community and more

Next to the search button in each chat's header are small tool icons. Each opens its own little window beside the chat, so you can keep chatting while it is open, and you can have several open at once.

The chat header icons: poll, prediction, user list, more tools, then search.
In your own channel, from the left: poll, prediction, user list, more tools, then search. In other channels moderators see user list and more tools, and everyone else just the user list.
Who can do what. Twitch lets only the channel owner start polls and predictions, edit the title and game, run raids and ads, and add markers through apps. So the poll and prediction buttons only appear in your own channel, and the raid, ad and marker items only show there too. In other channels, moderators can use Twitch's Mod View for those. Nothing here logs you out or breaks if you are only a moderator.

Polls

The poll window: a question, choices, a length, and recent polls with results.
Ask a question, add two to five choices, pick a length and press Start. Recent polls show their results below.

Predictions

The prediction window: an open prediction with two outcomes, lock now, cancel and refund, and pick the winner.
Start a prediction, watch the points and users on each side, then lock it and pick the winner (or cancel and refund).

Community (who is in chat)

The Community window: Broadcaster, Moderators, VIPs and Viewers in collapsible sections, with a Filter box.
Like Twitch's own Community tab: Broadcaster, Moderators, VIPs and Viewers, each with a count and a fold-away arrow, and a Filter box. Click a name for their user card.

It lists everyone connected to chat, including people who have not said anything, so you can find someone to moderate who has been quiet. It refreshes by itself about every 15 seconds. Twitch only hands the complete list to the streamer and moderators (and needs one extra permission, which YappyChat asks for the first time you open it). If you are not one of them, the window shows everyone YappyChat's chat connection has been told about plus everyone who has spoken, and says plainly that it can miss people in a very large chat. A very large channel shows the first few thousand names.

The Community button splits the chat you are in instead of floating over it: the list takes half of the pane, beside the chat when the pane is wide and above it (pushing the chat down) when it is tall, so chat stays in view. Press the button again to close it. The small arrow in its title bar moves the list above or below the chat, or to the left or right when the layout is horizontal.

More tools

The more tools menu: banned users, moderators and VIPs, shoutout, raid, ad, clip, marker, chat filters and two links.
The wrench opens the rest of Twitch's moderator toolbox.

Snap tools where you want them. Each tool window has a pin button. Press it, or drag the window over the right-hand column, and it snaps above the activity panel. YappyChat remembers which tools you snapped. Press the pin again to pop it out. Choosing the tool again, or its X, closes it. Tools that only the streamer can use (polls, predictions, raids, ads, markers, the title pencil and the streamer dashboard) are hidden from moderators.

The first time you use a tool that needs a permission you have not given, YappyChat explains what it is for and asks. You can say no and nothing changes.

Editing the title and game

In your own channel, a small pencil sits next to the stream title and game in the channel bar. Click it to change either one. Moderators do not see it, because Twitch lets only the streamer (and editors) do this through apps.

The stream info editor with the current title and game and a note about who is allowed.
The editor starts with the current title and game filled in.

Twitch decides who may change these per channel. If your account is not allowed, you get a clear message saying so and a link to Twitch Mod View, instead of nothing happening.

Channel notes and rules

A favourite feature, worth a minute. Every channel has its own book button (in the channel bar) with rules and private notes. Both are saved only on your computer and blurred in streamer mode.

Tip: save your mod guide link here. Most channels have a guide for their moderators (a Google doc, a Notion page, a Discord post). Paste the link into the notes for that channel and it is one click away whenever you are unsure. Do the same for the timeout lengths your team agreed on.

The notes and rules popover: rules you can click to send, and a private notes box.
The notes and rules popover: rules you can click to send, and a private notes box.

Highlights and blocklists

Highlights match the exact word, ignoring case. Mod highlights "mod" but not "mode". Add * as a wildcard: Mod* matches "mode", "moderator" and "mods". Tick regex on a row to use a regular expression instead. Each highlight has its own colour and sound.

Filters (Settings > Filters) hold two lists, next to the AutoMod display options and a button for the channel's Chat filters window. The blacklist is words or names you would rather not see: they are covered with a box and revealed when you hover. The shared ban list is people you want banned wherever you moderate: if someone on it speaks in a channel you moderate, Yappy offers to ban them (or YappyChat does it automatically if you switch that on). Add people from their user card. Both lists are blurred while streamer mode is on, stay on your computer, and use the same matching: exact, case-insensitive, * as a wildcard and /pattern/ for a regular expression.

Raids, Shield Mode and announcements

The Shield menu: slow mode, followers-only, subscribers-only, emote-only, unique chat and Shield Mode.
The Shield menu: slow mode, followers-only, subscribers-only, emote-only, unique chat and Shield Mode.

4. The streamer dashboard

If you stream, the pulse button next to your name and picture opens a dashboard of how your stream is going. It fills in while you are live and keeps the last session so you can look back after.

The streamer dashboard: tiles for viewers, chats and followers, a live viewers graph, chat activity, mod actions by kind, top chatters and alerts from your mods.
The dashboard, with sample numbers. Hover the graph to see the viewers at any moment.

Not live yet? The empty dashboard has a Preview with sample numbers button that fills it with made-up figures, marked SAMPLE, so you can see what everything looks like before your first stream.

Chat and mod counts only include your own channel while its tab is open in YappyChat. The dashboard tells you if it is not. Everything is kept on your computer.

Alerts from your mods

A moderator types /alert Your game audio is peaking, turn it down! in your chat window. On your screen YappyChat flashes in the taskbar, Yappy buzzes, and a large message appears, so you see it even mid-game. Got it dismisses it and Whisper back opens a reply.

A full-window alert reading 'Your game audio is peaking, please turn it down!' with Whisper back and Got it buttons.
What the streamer sees when a moderator sends an alert.

Streamer mode

Ctrl+Shift+S toggles streamer mode: the activity panel and chatter details are blurred, sounds are muted and Yappy's notices and desktop notifications are hidden. For screen sharing, also see Hide YappyChat from screen sharing.

5. Themes

Everything here is in Settings > Appearance.

Appearance settings: theme, I'm not a Moderator, colour vision and more.
Appearance settings.

The Themes menu in Settings > Appearance holds every look in one list (light or dark is the separate Colour mode setting). It offers:

The same chat in Default, Autumn, Winter, Summer, Spring and Minimal.
The same chat in each theme: Default, Autumn, Winter, Summer, Spring and Minimal.

Light or dark still applies on top of any theme, and the title bar at the top of the window follows your theme and mode.

Holiday themes

Halloween, Christmas, New Year and Valentine's Day switch on by themselves around the day (6 to 15 February for Valentine's), or you can pick one any time in the Themes menu. Valentine's gives the app pink colours and floating hearts, and Yappy gets heart eyes and a little heart headband. Supporters can also buy an animated Cupid's bow skin for Yappy.

The Valentine's theme.
The Valentine's theme.
Yappy with heart eyes and a headband.
Yappy with heart eyes and a headband.

Saving power

Settings > Appearance > Save power in the background pauses animations when the window is hidden or unfocused. It never pauses the stream.

Colour-vision modes

Choose Protanopia (red-weak), Deuteranopia (green-weak) or Tritanopia (blue-weak) under Colour vision. The app's status colours (the accent, warnings, bans and so on) change to a palette that stays easy to tell apart for that kind of colour vision. Two more switches go with it:

Deuteranopia mode with symbols on: the same chat, with a palette and name colours that are easier to tell apart.
Deuteranopia mode with symbols on: the same chat, with a palette and name colours that are easier to tell apart.

I'm not a Moderator

Not everyone who uses YappyChat moderates. Turn on Settings > Appearance > I'm not a Moderator and everything that is only for moderating disappears, leaving a clean chat client:

Chat, replying, emotes, whispers, mentions, the stream window and your themes all stay. You can switch it off again at any time and nothing is lost.

The same chat with I'm not a Moderator on: no mod buttons, no session counters, and a short activity rail.
With I'm not a Moderator on.

Yappy

Yappy is the mascot in the corner. He suggests actions when he notices patterns: repeated deletions of the same word, a spam wave, a possible raid. He also tells you about whispers and, when you log in, how many of your channels are live.

Yappy mid-buzz with crossed eyes.
Yappy mid-buzz.

In Settings > Yappy: Show Yappy shows or hides the mascot; Which notices to show switches off individual kinds (going live, whispers, raids, ban-list matches, spam, Shield tips, word suggestions, tip reminders); Yappy notices keeps notices as small pop-ups when Yappy is hidden, or turns all of them off; Suggestions turns pattern suggestions off entirely.

Sounds

The speaker button next to Settings changes the volume of all YappyChat sounds at once. In Settings > Sounds pick a tone for each event (highlight, watch-list chatter, someone going live, AutoMod, Yappy, first-timer, whisper, alert) or choose your own file: an mp3, wav or ogg up to 500 KB and 5 seconds.

Stream window

The stream button opens Twitch's own player, unmodified and following Twitch's embed rules: it is always at least 400x300 and nothing is drawn over it. It uses the same Twitch login as chat, so your subscriptions and Turbo apply.

Snapping. Drag the stream window (or a chat) towards the edge of the chat area and a highlight shows where it will dock. This works with a single chat too, so you can put your chat above, below, left or right of the stream. GIFs sent in chat, pinned messages and drops show in the line and in a strip above it, each with an X to dismiss; Settings > Chat has a switch for each.

Several streams

Press the + next to the channel menu to add another stream, up to four. From two streams on, the streams sit along the top of the chat area and your chats below, and streams plus chats never go over six panes: 4 streams and 2 chats, 3 streams and 3 chats, 2 streams and 4 chats. Your saved split view is kept, so closing a stream gives the chats their room back. Each stream has its own channel menu and a × to close it; closing the first one makes the next one the main stream.

Four streams along the top, each with its own channel menu, plus and close buttons, and two chats below.
Four streams and two chats: six panes. (The streams here are placeholders; in the app each one is Twitch's own player.)

6. Security

YappyChat keeps your Twitch login encrypted by Windows for your user account only, never sends your chat anywhere, and asks Twitch for as little as it can. Settings > Security adds more:

Security settings: passcode, idle lock, hide from screen sharing, revoke on logout, and alerts.
Security settings.
SettingWhat it does
App lock (passcode)Asks for a passcode when YappyChat starts and after the idle time you choose (5 minutes to 1 hour), so nobody can read your chats, notes and whispers or moderate as you if you walk away. Only a salted, slowed-down hash of the passcode is kept, never the passcode itself, and repeated wrong tries make you wait. Lock now locks it straight away. If you forget it, the lock screen offers to log you out, which removes the lock.
Hide from screen sharing and recordingYour window shows as black in OBS window captures, Discord screen share and screenshots, so notes, whispers and mod tools can not leak on stream. You still see everything.
Revoke my Twitch login when I log outLogging out also tells Twitch to cancel the login token (on by default).
Accept /alert messagesTurn off the full-window alerts if you do not stream.
Lock when Windows locks or sleeps, or when sent to the trayOnce a passcode is set, YappyChat also locks itself when Windows locks or goes to sleep, and when you close the window to the tray (both on by default).

The list of everything YappyChat can do on your Twitch account (Granted or Not granted, with a plain reason for each, plus a button to review the apps connected to your Twitch account) is in Settings > About, along with Reset window layout.

Settings, About: each permission YappyChat can use with Granted or Not granted, and buttons to grant the optional ones or review connected apps.
Settings > About lists every permission and whether it is granted.

Behind the scenes, YappyChat also limits its own web requests to the handful of addresses it needs and denies browser permissions such as camera and microphone. See the privacy page.

Startup, tray and updates

In Settings > General:

General settings: start with Windows, tray options, stream settings and more.
General settings.

7. Supporter perks

YappyChat is free. Supporters get a Yappy-shaped badge (white, bronze, silver or gold by the total spent on perks), name effects, name plates, titles, entrance effects, animated Yappy skins, sound packs and seasonal packs. See the prices and how to get them. You tick what you want in a cart (the heart button in the app opens it already signed in), sign in with Twitch, and pay by card, Apple Pay, Google Pay or PayPal. Your perks switch on by themselves as soon as the payment is confirmed; press Check for new perks in Settings > Your Perks if they are not there yet. Refunds within 14 days are covered on the privacy page. Choose what you wear in Settings > Your Perks; everyone using YappyChat sees your choices within a few minutes.

The Support Yappy shop (the heart button), here on the Partners tab.
The Support Yappy shop (the heart button), here on the Partners tab.

Hover to learn

Hover a supporter's name, badge or title to see what it is, how it was earned, and what it costs, so you can get one too. Click it to open the shop. On the website's supporter wall, cards from Bronze upwards shine.

Hovering a badge explains it.
Hovering a badge explains it.
The supporter wall inside the shop.
The supporter wall inside the shop.

Partner streamers

Some streamers have collections made with them: a Yappy skin, a colour theme, a badge and a title, plus a bundle. They live on the Partners tab of the shop, each with the streamer's name and a link to add their channel. Partner badges and titles show to everyone, with a tooltip naming the streamer. Streamers who want a collection can find out more on the Get involved page.

Troubleshooting

"Session expired" or I keep being asked to log in

Log in again from the login screen. If it happens every time, update to the latest version.

A tool says it needs one more permission

That is expected the first time. Press Grant permission; you sign in to Twitch once and the tool opens. Settings > Security shows what is granted.

I cannot see the poll and prediction buttons

Twitch only lets the channel owner run these through apps, so the buttons (and raids, ads, markers and the title editor) only appear in your own channel. In someone else's channel, use Twitch's Mod View.

Mod actions or AutoMod are empty

You must be a moderator in the channel, and you need the latest permissions: log out and log in again.

Whispers or /alert do not arrive or cannot be sent

Log in again for the whisper permissions. To send, your Twitch account needs a verified phone number. For /alert the streamer must be using YappyChat and must not have turned alerts off.

A window is hidden, off the edge or in a strange place

Open Settings > About > Window layout > Reset. It closes and re-centres the stream window, turns split view off and puts the panels back to their default sizes. (This also happens by itself the first time YappyChat runs, so the welcome guide is never hidden behind a stream window.)

I do not see the mod buttons, tabs or tool icons

Check Settings > Appearance > I'm not a Moderator is off, and that you actually moderate that channel.

YappyChat feels slow on my computer

Choose the Minimal theme, turn on Save power in the background, and shorten Keep Firsts and Joins for in Settings > Chat.

Emotes show as grey text

Open Settings > Emotes, press Reload emotes and Test emote images, and check your internet connection.

Recent messages are empty

The channel may be brand new to the recent-messages service, or you may have it switched off in Settings > Chat.

I forgot my passcode

On the lock screen choose Forgot it? Log out. That removes the lock and logs you out of Twitch; log in again to continue.

Where are my logs?

Chat logs are saved per channel per day in %APPDATA%\YappyChat\logs. Use the file button in the top bar to open the folder.

Shortcuts

KeysAction
Ctrl+KJump to a channel
Ctrl+FSearch the chat you are in
Ctrl+Shift+FSearch all channels
Ctrl+Shift+SStreamer mode
Ctrl+Shift+PCommand palette
TabComplete an emote or @name
↑ ↓In the message box: your last 10 messages
EscClose a panel or window
D T B WDelete, timeout, ban, warn (hover hotkeys)
/search · /alertSearch this chat · send the streamer an alert

FAQ

Is YappyChat official?

No. It is an independent app that uses Twitch's public APIs. It is not affiliated with or endorsed by Twitch.

Is it safe?

Your Twitch token stays on your computer, encrypted, and you can add a passcode lock. The only server YappyChat talks to besides Twitch, the emote services and the recent-messages service is the YappyChat supporter server, which receives your token only to confirm who you are when you change your perks (it does not keep it). See Security and the privacy page.

Why can I not start a poll or prediction as a moderator?

Twitch's own rules: only the channel owner can start them through an app, so YappyChat shows those buttons only in your own channel. See Polls, predictions, user list and more.

Does it work with Kick or YouTube?

Not yet. Both are coming soon. Tabs already have a coloured line to show which service a channel is on, ready for them.

Does it work on Mac or Linux?

Currently Windows only.

I have a suggestion, or something is broken

Use the lightbulb button in the app's top bar, or write to us on the contact page.