Donation Goals

Comes with strAImer: this module is installed together with the app, so there is nothing to download. It is listed under Module Catalog → Built-in.

What this page is

Donation Goals is a list of fundraising bars for OBS. Each goal in it is its own overlay with its own target, its own look and its own link — a general one that stays on screen, one for tonight, one nobody sees yet. Incoming donations add themselves up; this page is where the titles, the numbers and the looks are set.

The list

Every goal is a row: a switch, its name, how much it has collected of its target, Copy link for OBS, and the buttons Pause, Duplicate, Delete and Configure. The link itself is not shown on the page; the button is the only way to get it.

• Create widget in the header adds a goal and opens its settings straight away.
• Configure opens the settings of that goal; Back to list returns.
• Pause stops that goal counting and leaves the amount where it is. The row then says paused and the button turns into Resume, which picks it up from there.
• The switch at the start of the row turns the goal off completely; pointing at it shows Count donations and show in OBS. Switched off, the goal has no bar in OBS in any scene, takes no donations, and the row says off. Switched back on, it carries on from the same amount; donations that came in while it was off are not added.
• Before strAImer 0.25.0 the switch only hid the bar, and a goal switched off kept collecting. If you kept a goal off so it would collect quietly, it stops growing after the update. To collect without viewers seeing it, leave the switch on and hide the source in OBS with the eye. To keep the bar on screen without counting, use Pause.
• Donations go into every goal that is switched on and not paused. The switch and pause are how you choose where money lands.
• Duplicate copies the settings and the look but not the money: the copy starts at zero.
• Delete asks first and names the amount that will disappear with it.
• Count donations from sits under the list, because it is one setting for every goal: "An unchecked source does not move the goal bar. New sources are counted automatically."

How to set up one goal

1. Press Configure in the row. In the middle is a live preview of the bar — title, bar and the progress text on it, written as 6500 / 10000 (65%). The name of the goal is the field in the header, next to Back to list.
2. In the left column pick Goal Data.
3. Goal Title is the line above the bar — what viewers read. Leave it empty and it reads Fundraising, in the language of the application. It is not the same as the name in the header: that one is only for the list.
4. Target Amount is the number the bar fills up to; 1 is the smallest it takes.
5. Current Amount is where the bar stands right now. Donations move it themselves, so you normally touch it only to correct the figure or to start over — put 0 there for a new stream. The field keeps up with live donations while you have the page open, and pressing Save Settings without touching it does not roll the bar back. Reset next to the field puts the collected amount back to zero — the same goal starts over, keeping its look, its title and its OBS link. It asks first and names the amount: that number is not stored anywhere else.
6. The rest of the left column is the look: Backdrop, Material, Outline effect, Title, Bar, Fill, Progress Text, Goal Bounds and Edge padding. Goal Data comes last, under all of them. Opening a goal puts you on Backdrop. Backdrop is the panel behind the title and the bar: Block width, Background Color, Corner Radius, Padding, Border and Shadow. Block width is how wide the whole goal is, 600 px to begin with. The goal stands in the middle of the Browser Source and is never wider than this number, so on a wide source it stays a narrow strip until you raise Block width. A wider source only leaves more empty room around it. The panel is invisible until you give it a background — the bar looked that way before the setting existed, and an overlay already in your scene must not change by itself. Colours, sizes, fonts, corner radius, borders and glow open on the right, and the preview follows every change at once. The look belongs to this goal alone.
7. Progress Text decides what the bar says. What the Text Shows offers five forms — raised of goal with the percent, without it, raised with the percent, raised only, percent only — and Do not show for a bar with no numbers at all. Amounts carry digit grouping and your base currency. Text Position puts the line on the bar or under it; under it the size is not limited by the height of the bar.
8. Goal Bounds is a row under the bar: zero on the left, the target on the right, what is raised in the middle. It is hidden until you turn it on — an overlay already in your scene must not change by itself. Edge padding has Top and bottom and Left and right: a transparent margin between the edge of the Browser Source and the goal, so that glow and shadows are not cut off at the edge.
9. Styling above that list swaps the whole look: the built-in Neon, Minimal, Retro, twelve looks named after the materials, plus templates of your own. Nothing is written until you press Save Settings; see Styling an Overlay. Material, right under Backdrop, draws the goal in one of twelve styles: the bar and its fill always, the Backdrop panel only once it has a background, a border or a shadow. Under a material the Border fields are hidden, and some shadows too, because the material draws its own edge. Outline effect runs one of ten effects around the goal; under Plays, On event flashes it each time the collected amount grows. How materials and effects work in every overlay is in Styling an Overlay. Fill Gradient in Fill takes a transparency for each of its colours, so the fill can fade from solid to see-through.
10. Test Progress above the preview drags the bar from 0 to 100% so you can see a filled bar without waiting for donations. The − and + buttons on the right (Zoom out / Zoom in) scale the preview.
11. Press Save Settings in the page header. The button itself reports Saving…, Saved or Error.
12. The link for OBS is taken in the list, not here: Copy link in the row of that goal. It goes into a Browser Source in OBS.
13. Reset Customization puts the default look back on screen and leaves the numbers alone. It is written when you press Save Settings.

What it cannot do

• No per-stream history. A goal knows what it has collected in total, not how that came about; there is nothing to look back at once you set the amount to 0.
• Pause does not undo what already landed. It stops the counting from now on.
• Test Progress moves the preview only — the amount in the overlay stays where it was.
• Nothing resets on its own: at the start of a new stream you set Current Amount back to 0 yourself.
• Money is counted in the base currency of the application, the one on Settings → Localization — this page has no currency of its own.
• A donation in a currency the app has no rate for is not counted towards any goal, and the bar stays where it was. Rates live on Settings → Currency Rates; see the guide "Currency Rates".
• Only what arrives as a donation moves the bar; there is nothing here for followers, raids or channel point rewards.
• Target Amount is marked as taking nothing below 1, but nothing enforces it. A fraction like 0.5 is saved as typed; zero, a negative number and an empty field are all silently replaced with 10000, so you get a target you never set and no warning that it happened.
• The fill stops at 100%, the number does not. Overshoot a goal and the bar sits full while the caption reads 120% — deliberately, because a bar that looked full at 120% would read as "exactly done". On the percent only view that number is the only thing in frame.
• The goal always stands in the middle of its Browser Source; there is no pinning it to an edge. Where that source sits in the scene is set in OBS, and the width of the goal is Block width.
• The overlay shows the title, the bar and the numbers — no donor names, no last donation.
• A goal you delete takes its money with it, and nothing brings that amount back. Since strAImer 0.25.0 the app remembers which goals each donation went into, but only so that deleting that donation in Statistics takes back from each goal what it got; see the guide "Stream statistics".
• A link copied before the list existed still works and shows the first goal, so old Browser Sources in OBS keep going. There is no way to point that old link at another goal — copy the link of the goal you want instead.