Carousel Bar

Installed separately, as part of the Carousel bundle: this module does not come with the app installer. Open Module Catalog → Add-ons and press Install on the Carousel card, and the bundle installs all of its modules at once.

What this page is

Carousel Bar is the small progress card for OBS that shows how the pool is filling — "The pool bar for OBS: how much is collected and how much is left until the spin". It lives at Carousel → Pool bar overlay. The money it shows comes from the Carousel page; this page only decides the wording, the sound and the look.

The card is always three rows high: a title with a status slot, the bar, and the amounts. Nothing appears or disappears — only the contents of the slots change — so a source pinned next to other elements in OBS never jumps.

How to set it up

The page opens on the list of widgets, not on the settings. Create widget sits above it; the first widget is called Main and a new one arrives as New widget. Each row has an On air switch, the widget's name, a one-line summary of its settings and the buttons Copy link, Duplicate, Delete and Configure. Delete appears only once there are two, because the last widget cannot be removed. Configure opens the settings described below and takes you back to the list. Every widget keeps its own link and its own look, so two of them can stand in different scenes at the same time.

On air off takes that bar off the stream at once, without Save: it leaves the frame and stays silent, with no discount sound, no flashing, no winner line and no effect, and the row is marked Off. The carousel keeps collecting and spinning. Switched back on in the middle of a discount, the bar shows the time left without chiming. A bar deleted from the list goes dark the same way, even if its link is still in OBS. To stop the carousel itself, use Turn off on the Carousel: Control tile.

1. Open Carousel → Pool bar overlay. Copy in the header copies the address, and the message confirms it: "The link is copied — paste it into a Browser Source in OBS". A size of 600 x 160 suits it.
2. The preview sits in the middle. Fill drags it from 0 to 100% so you can judge a full bar without waiting, Show the discount puts a discount into the status slot — the button then reads Hide the discount — and Show a win plays the winner line. The − and + on the right (Zoom out / Zoom in) scale the preview.
3. The sections are listed down the left: Backdrop, Material, Outline effect, Bar, Title, Amounts, Discount, Winner line, Edge padding and Text and sound.
4. Text and sound is where the words are. Show the title switches the line above the bar on and off. Title above the bar under it: "Leave it empty for the default title", which reads Next spin in the language of the application. To remove the title, turn Show the title off; emptying the field brings the default back instead.
5. Winner line in the same section is the sentence shown for a few seconds after a card comes up. Leave it empty for the built-in one, "{name} won "{card}"", or write your own with the {name} and {card} chips below the field. The hint says it plainly: "Your own text is not translated — it stays as you wrote it."
6. Show the percentage — "In the slot on the right, when there is no discount and no queue". The slot shows one thing at a time, and it goes by importance: a running discount pushes out the queue, the queue pushes out the percentage.
7. Sound when the discount starts is a slot: ▶ plays the sound, clicking the slot opens the Choose a sound window, and Volume sets how loud. Any folder can be opened in that window; the chosen file is copied into the app's sounds folder (Settings → Sound).
8. The other sections are the look. Backdrop: Background, Border, Corner radius, Padding, Gap between rows, Shadow. Bar: Background, Fill, Height, Corner radius, Border, Shadow. Title, Amounts and Winner line each hold their own Font, Size, Color and Shadow, with Weight on the title and the winner line. Discount has Color, Size and Glow for the moment the status slot lights up. Edge padding has Top and bottom and Left and right, in pixels: the space between the source edge and the card.
9. Material draws the backdrop, the bar track and the fill in one of the twelve themes, and each theme brings its own detail colours. While a theme is on, Border in Backdrop and Bar is hidden, and under some themes Shadow too, because the theme draws them itself. Outline effect runs around the backdrop: in Plays, All the time keeps it going and On event flashes it when a carousel card drops, a spin started from the panel included. The backdrop spans the full width of the source by default, so set Left and right in Edge padding to keep the effect from being cut off at the sides. How themes and effects work in general is in the guide "Styling an Overlay".
10. Ready-made looks and your own saved templates sit in the Styling card above the section list. Open "-- Choose a template --", take one from Built-in (Neon, Minimal, Retro and the twelve themes), Mine — this overlay or Mine — from other overlays, and press Apply. Template name with Save keeps the current look, Delete removes one of yours.
11. Press Save in the page header.

After updating to strAImer 0.25.0

Refresh the pool bar source in OBS once by hand: open the source's properties in OBS and press Refresh cache of current page. Until then OBS keeps running the previous version of the bar, which knows neither the On air switch nor the themes. This is the last update that needs it: from now on the bar reloads by itself after an update, waiting until the discount sound and the winner line have finished.

Loading or refreshing the source in the middle of a running discount does not play the discount sound and the flash a second time.

What it cannot do

• The bar shows what the Carousel page collects. A bar with no fill means the pool is empty, not that the link is wrong. When a scene loads, the bar waits for the carousel and appears only once the carousel has answered, so the source stays empty while the carousel is switched off on Carousel: Control or not running at all. It is also empty when On air is off in the bar's row or the bar was deleted from the list.
• Amounts are in your base currency, the one on Settings → Localization. There is no currency setting here and no conversion for the viewer.
• The status slot holds one thing. The discount, the queue and the percentage cannot be shown side by side, and the order between them cannot be changed.
• The winner line needs a name. A spin started from the button rather than by a donation has nobody to name, so the amounts simply stay in place.
• Nothing on this page changes the target, the discount or the pool. Those are on the Carousel page; the bar only reports them.
• There is no history on the bar — it shows the pool as it stands now, not the spins that already happened.
• Where the card sits and how wide it is come from the Browser Source in OBS. Edge padding only moves the card away from the source edges; there are no position or width fields.
• Each pool bar in the list has its own link, wording, sound and look. The bar is a separate Browser Source from the carousel ribbon: adding one does not add the other.