{"obs-overlays":{"sections":{"browser-source":{"title":"Add your overlay to OBS","steps":["Open Widgets in the dashboard and choose the “Your InstiBot overlay” tab.","Copy the overlay URL. It is blurred on screen until you hover it, because it is private.","In OBS, add a Browser source to your scene and paste the URL. Set the size to 1920×1080.","Back in the dashboard, use Test on stream to send a test follow or tip and check it appears."],"paragraphs":["That single source shows every widget you switch on, each in its own place on a 1920×1080 stage, scaled to the source size. Any 16:9 size works the same way. Nothing is visible while nothing is happening, so the source can stay on top of your scene."]},"widgets":{"title":"Choose what appears","paragraphs":["The “What’s in your overlay” list has a Show in overlay switch and a Configure button for every widget. Alerts, mini-games, shoutouts, polls, predictions, the viewer queue and the now playing card are on by default. The chat overlay, goals, event labels, the subathon timer and the viewer counter are off until you switch them on.","Changes you save in the dashboard reach the overlay straight away; you never need to refresh OBS after editing a widget."]},"layout":{"title":"The layout editor","paragraphs":["Widgets → Layout editor shows a 1920×1080 canvas. Drag a widget to move it, drag its corner to resize, use the arrow keys to nudge it, or type exact X, Y, width, height and scale values. Quick place buttons snap a widget to a corner or an edge with a safe margin. Turn on “Show saved overlay behind” to see the live overlay under your boxes.","All mini-games share one zone, because only one game is on screen at a time. Some default positions overlap, such as goals and labels in the top left, so check the layout once when you switch new widgets on."]},"library":{"title":"Separate sources for single widgets","paragraphs":["If you want a widget in a different scene or with its own filters in OBS, open the widget, expand “Advanced: separate Browser Source” and copy the widget-only URL. A widget-only source fills its own size instead of using the 1920×1080 stage. Hide that widget from the main overlay, or it will show twice."]},"privacy":{"title":"Keep the URL private","paragraphs":["The overlay URL contains a token that works like a password for your overlay and OBS docks. Don’t show it on stream or share it. If it leaks, press Regenerate next to the URL: every overlay and dock URL changes at once, and you paste the new one into OBS. Old URLs stop working immediately."]},"blank":{"title":"When the overlay stays empty","bullets":["Check that the whole URL was pasted, and that it isn’t an old one from before you pressed Regenerate. An old or partial URL loads but never shows anything.","Add ?debug=1 to the end of the URL in a normal browser: a small badge shows whether the overlay is connected.","Make sure the widget is switched on under Show in overlay.","Event widgets are invisible until something happens. Send a test from Test on stream.","Alerts wait up to 2 minutes for an overlay to connect, then they are skipped. Keep OBS open with the source loaded while you are live.","If the same widget is in two sources, it plays in both."]},"faq":{"title":"Questions","faq":[{"q":"Are the overlays free?","a":"Yes. Every widget works on the free plan. Premium raises upload limits and unlocks custom code and more variants for alerts."},{"q":"Do I need special OBS settings?","a":"No. A Browser source at 1920×1080 is enough. Sounds from alerts and text to speech play inside the source, so OBS captures them with the source audio."},{"q":"Does it work with Streamlabs or other software?","a":"Any streaming software with a browser source can load the same URL."}]}}},"chat-overlay":{"sections":{"setup":{"title":"Add chat to your stream","steps":["Open Widgets → Chat overlay.","Switch on Show in overlay. The chat overlay is off by default.","Pick a theme, font and size, then use the Test button to send a sample message to your overlay.","Place it in the layout editor, or copy the widget-only URL under Advanced if you want chat as its own OBS source."]},"platforms":{"title":"Every platform in one box","paragraphs":["The chat overlay shows messages from every connected platform together: Kick, Twitch, YouTube and TikTok. Turn on “Show the platform” to put a small platform icon before each name when you stream to more than one platform.","Kick and Twitch emotes appear as images, animated where the platform provides it. YouTube and TikTok messages are shown as text, and names from those platforms use your chosen name colour because they don’t carry one."]},"look":{"title":"Themes and readability","table":{"headings":["Setting","Default","What it changes"],"rows":[["Theme","Kick style","Kick style, Bubbles, Plain text or Boxed."],["Font and font size","Inter, 22 px","From 10 to 64 px."],["Bubble background","Dark, semi-transparent","Colour and opacity are set separately."],["Text direction","Automatic","Each message also detects its own direction, so Hebrew and Arabic read right to left."],["Max messages","12","How many lines stay on screen."],["Fade out after","10 seconds","0 keeps messages until they are pushed out."]]}},"filters":{"title":"What is hidden","bullets":["Hide commands removes messages that start with your command prefix, so !commands spam stays off stream.","Hide bots removes listed accounts. InstiBot’s own replies never appear in the chat overlay.","Messages that InstiBot’s moderation filters remove are taken off the overlay too.","Subscriber badges use your Kick channel’s badge images automatically; upload your own image for any tier."]},"limits":{"title":"Good to know","bullets":["Chat keeps showing even when the chat bot is switched off; only commands and moderation pause.","The overlay starts empty each time it loads and only shows new messages.","YouTube chat appears only while you are live; TikTok chat only while you are LIVE on TikTok.","Messages deleted directly on the platform stay on the overlay until they fade out."]},"faq":{"title":"Questions","faq":[{"q":"Is the chat overlay free?","a":"Yes, on every plan."},{"q":"Can I show only my Kick chat?","a":"The overlay shows every connected platform. If you only want Kick, connect only Kick."}]}}},"stream-alerts":{"sections":{"setup":{"title":"Set up your alerts","steps":["Add your overlay to OBS once (see the OBS overlays guide). Alerts are on in it by default.","Open Alerts in the dashboard. Each alert type has its own tab.","Choose a layout, add an image or video and a sound, and edit the text template. The live preview updates as you change things.","Press the test buttons at the top to play each alert on your overlay. Tests never post in chat or move goals."]},"types":{"title":"Alert types and platforms","table":{"headings":["Alert","Where it comes from"],"rows":[["Follower","Kick, Twitch and TikTok follows. YouTube has no follow event."],["Subscription","Kick subs and renewals, Twitch subs and resubs, YouTube memberships, TikTok subscriptions."],["Gift Sub","Gifted subs on Kick and Twitch and gifted memberships on YouTube."],["Host","Kick hosts and Twitch raids."],["KICKs, Bits & gifts","Kick KICKs, Twitch Bits and TikTok gifts."],["Tip/Donate","PayPal tips from your InstiBot tip page and YouTube Super Chats and Super Stickers."]]}},"design":{"title":"Design: classic layout or visual editor","paragraphs":["The classic layout has three styles (Compact, Classic and Banner), three ways to arrange image and text, 38 entrance and exit animations, a name animation, fonts, colours and a duration from 2 to 30 seconds.","Switch to the visual editor to build an alert from up to 12 layers of images, videos, text and shapes on an 800×600 canvas, each with its own timing and animation. Start from a template or from scratch; it works on every plan.","Text templates use tokens such as {name}, {amount}, {months}, {gifter}, {currency} and {message}. The defaults read like “{name} followed!” and “{gifter} gifted {amount} subs!”."]},"voice":{"title":"Sounds and text to speech","paragraphs":["Every alert can play a sound file at its own volume. Text to speech reads the viewer’s message aloud in a natural female or male voice, with the language detected per message. It is on by default for tips, and for tips and KICKs you can set a minimum amount before a message is read. Messages are read up to 300 characters, without links or emote codes."]},"variants":{"title":"Variants for bigger moments","paragraphs":["Variants are alternative versions of an alert. A variant plays when the amount or months reach a value, when the event comes from a specific platform, or by random chance, and can change everything: design, sound and voice. If several match, an exact value wins, then the highest minimum reached. Free channels can add 5 variants per alert type, Premium channels 25."]},"live":{"title":"The alert queue during a stream","paragraphs":["Alerts play one at a time, in order. Twenty follows in a row are twenty alerts; a mass gift is one. Pause alerts, resume them or skip the current one from Alerts → Advanced settings → Tools, from the activity feed, or from the Activity dock inside OBS, which can also mute alert sounds.","If no overlay is connected, alerts wait up to 2 minutes and are then skipped. The activity feed keeps 90 days of events, and any event can be replayed with your current design."]},"uploads":{"title":"Uploads and limits","table":{"headings":["","Free","Premium"],"rows":[["File size per upload","5 MB","50 MB"],["Media library","300 MB","3000 MB"],["Variants per alert type","5","25"],["Custom HTML, CSS and JavaScript","No","Yes"]]},"paragraphs":["Images can be PNG, JPEG, GIF or WebP, videos WebM or MP4, and sounds MP3, OGG or WAV."]},"faq":{"title":"Questions","faq":[{"q":"Can I hide alerts below a certain amount?","a":"There is no minimum for showing an alert, but a variant can style small and large amounts differently, and text to speech for tips and KICKs can start from a minimum amount. To stop an alert type completely, switch off Active alert on its tab."},{"q":"Do channel-point redemptions trigger alerts?","a":"No. Redemptions appear in the activity feed and the Redemptions dock, but they don’t play alerts."},{"q":"Why didn’t an alert play?","a":"Check that the alert type is active, that OBS had the overlay open (alerts are skipped after 2 minutes without one), and that alerts weren’t paused. The activity feed shows each event’s status."}]}}},"subathon-timer":{"sections":{"setup":{"title":"Set up a subathon","steps":["Open Widgets → Subathon.","Set the start duration (60 minutes by default) and, if you want one, a maximum length.","Choose how much time each event adds under Time per event.","Pick a style, title and colours, and add milestones if you plan rewards at certain lengths.","Press Start subathon when you are ready. The timer appears on your overlay from that moment."]},"events":{"title":"Time per event","table":{"headings":["Event","Default","Notes"],"rows":[["Sub","60 seconds","Counts new subs and, unless you turn it off, resubs."],["Gifted sub","60 seconds each","A gift of 5 adds five times as much."],["KICKs, Bits and TikTok coins","60 seconds per 100","Counted pro rata, so 50 adds half."],["Tip","12 seconds per unit","PayPal tips and YouTube Super Chats in your tip currency."],["Follow","Off (0)","Set a value to let follows add time."]]},"paragraphs":["Events from every connected platform count the same. Raids, chat activity and channel-point redemptions don’t add time. Events only count while the subathon is running or paused."]},"commands":{"title":"Control it from chat","paragraphs":["Anyone can type !subathon to see the time left. Moderators can start, pause, resume, add or remove time and reset it. Times can be minutes (10) or use a unit: 90s, 15m or 1.5h."]},"dashboard":{"title":"Control it from the dashboard","paragraphs":["The Timer card shows the status and has Start, Pause, Resume and Reset, plus buttons to add or remove 1, 5 or 10 minutes and a box for any number of minutes. Manual changes aren’t limited by the maximum length.","The timer’s state is saved on the server, so it survives an OBS restart, a refreshed overlay and server updates. Once it reaches zero it shows your ended text until you start again or reset."]},"look":{"title":"Look and milestones","paragraphs":["Choose from four styles (Card, Text only, One line and Stacked), a time format, fonts, colours, borders and images beside or behind the timer. Each time event adds time, the added amount and who added it pop up on the timer, with an optional sound.","Add up to 20 milestones such as “12 hours: face reveal”. With “Show the next milestone” on, the overlay always shows the next one not yet reached."]},"rules":{"title":"Explain your rules to viewers","paragraphs":["Publish how much time each event adds and keep it in line with your settings; the line under the timer is a good place for “!subathon for the rules”. Tips only count in your channel’s tip currency, so a Super Chat in another currency plays its alert but doesn’t add time."]},"check":{"title":"Before a long stream","bullets":["Use the test buttons: the added time pops up on the overlay without changing the real timer.","Decide on a maximum length before you start. Events stop adding time once it is reached.","Make sure your moderators know the !subathon commands.","Keep the overlay URL private."]},"faq":{"title":"Questions","faq":[{"q":"Is the subathon timer free?","a":"Yes, on every plan."},{"q":"Can I run two subathons at once?","a":"There is one subathon timer per channel."}]}}},"stream-goals":{"sections":{"goals":{"title":"Create a goal overlay","steps":["Open Widgets → Goal and choose a supported goal type.","Set the target and appearance, then save.","Add that goal’s widget URL to an OBS Browser source.","Verify that the event type and currency match the contributions you intend to count."]},"labels":{"title":"Show events and viewer counts","paragraphs":["Event labels present stream activity without a full alert animation. The viewer counter provides a separate display for viewer-count information. Configure each widget in its own editor and place it where it remains readable during gameplay."]},"totals":{"title":"Understand the totals","paragraphs":["Not every event is available on every platform. Paid-event labels and totals can also depend on currency settings. Compare the saved widget configuration with the platform-support guide when a total differs from what you expected."]}}},"engagement-widgets":{"sections":{"choose":{"title":"Choose a widget for the moment","table":{"headings":["Widget","Use it for"],"rows":[["Emote wall / combo","Bring chat emotes onto the stream"],["Shoutout","Give another creator a moment on screen"],["Hype train / the cup","Visualize supported community activity"],["Birthday","Show a configured birthday celebration"],["Stage","Arrange a stage presentation"],["Pinned messages / credits","Keep a message visible or acknowledge participants"]]}},"setup":{"title":"Use the widget editor","paragraphs":["Open the corresponding page in Widgets. Review its settings, supported triggers and plan availability. Add the supplied widget URL to OBS and use its preview or test controls where available.","Start with one widget and check placement before enabling several at once. A busy screen can obscure both your content and other alerts."]},"expectations":{"title":"Check the trigger","paragraphs":["An empty overlay may be waiting for an event rather than failing to load. Confirm its enabled state, event rules and platform support before changing the OBS source."]}}},"media-and-tts":{"sections":{"media":{"title":"Show media on stream","paragraphs":["The Media and Stream media pages provide the supported media controls. Choose the placement and presentation in the editor, then add the widget source to OBS. Test the actual image, animation or video you intend to use."]},"tts":{"title":"Configure text to speech","paragraphs":["Open Widgets → Text to speech to review the available voice, access and playback settings. Test a short message and confirm the audio reaches your stream output.","If you connect viewer text to a reward action, review who can trigger it and the moderation rules before enabling public use. Give moderators a way to respond during the stream."]},"safety":{"title":"Check media and sound","bullets":["Use media and audio you have permission to broadcast.","Test volume with the rest of your OBS audio mix.","Keep player and widget URLs private.","Check plan and integration availability in the editor."]}}}}