Timers

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

What this page is

Timers (Widgets → Timers) is a list of countdowns and stopwatches for OBS. Every timer is its own overlay with its own link, look and caption: one counts down to the start of the stream, another counts how long you have been live, a third runs a marathon that donations add time to. The time itself is kept by the app, not by the browser source, so reloading the source or restarting OBS loses nothing.

Closing strAImer does not pause a timer either. A timer remembers the moment it ends or started, not a ticking number, so a running countdown keeps running down while the app is closed, and a count-up counts that time too. To stop it, press Pause on the Timers: Control tile first. A countdown to a date and a count-up that follows the clock (At a date and time, or an event with Start over on every such event) have no Pause: they show the real time on purpose. Pause while you are offline only acts while the app is running, and does not give back the time that passed while it was closed.

The page comes with the Timers bundle from Module Catalog → Add-ons, together with Timers Engine, which counts the time, and the Timers: Control tile for the Control Panel. The first timer is created by itself: a ten-minute countdown that starts with a button. Everything that changes the time without you is off until you turn it on.

The list

Every timer is a row: a switch, its name, a short line on what it counts and when it starts, Copy link for OBS and the buttons to duplicate, delete and configure it.

• Create timer in the header adds a timer and opens its settings.
• Copy link copies the address for OBS. Add it in OBS as a Browser source.
• The switch turns a timer off: it takes no donations, buttons or scenario steps, does not fire at zero, and its overlay goes blank. A marathon of a set length freezes and goes on from the same place when you turn it back on; a timer to a date or from the stream start keeps running, so that it shows the truth when it comes back.
• Journal shows the latest hundred changes of time: who, by how much and how.

How to set up a timer

1. Press Create timer, or configure a timer in the list. On the left are the sections, in the middle a live preview. Under the preview, Start, Reset, +1 min, −1 min and Show a change try the timer out: they work on the saved timer, so press Save first. Only the buttons this timer has are shown, the same as on the tile (see «The Timers: Control tile» below).
2. In Counting, choose the Direction: Count down: how much is left or Count up: how much has passed.
3. For a countdown, Count down to is either A set amount of time (How long, in hours, minutes and seconds) or A date and time (Until). A countdown to a date runs on its own: there is nothing to start.
4. When to start: With a button, At a date and time (Start at) or On a stream event (Which event: Stream start, Donation, Subscription, Channel points reward, Raid or Follow). A start at a date and time counts from that moment even if the app was opened later, so a marathon set for noon still ends on time.
5. Start over on every such event makes a count-up begin again with every new event: «since the last donation» starts over with each donation, and «live for» starts over with every stream. Without it, the next stream carries on from yesterday.
6. At zero: Stop at 0:00 or Keep going below zero. Pause while you are offline holds the timer when the stream drops and goes on when you are back.
7. Format chooses how the digits look: Hours only when needed: 9:59, 1:00:00, Always hours: 00:09:59, Minutes only: 90:00 or With days: 1:02:30:00.
8. In Caption, Text next to the timer is the line viewers read, for example «STREAM TIME:». Leave it empty to show only the digits. Where it stands, above, below or beside the digits, is chosen in the look: Caption, then Position.
9. The look has its own sections: Backdrop, Material, Outline effect, Digits, Caption, Changes and overtime and Edge padding. Styling above them offers the ready-made Neon, Minimal and Retro and twelve looks named after the materials. Material draws the timer plate in one of twelve styles; under a material Border is hidden, and Shadow too for some of them. Outline effect runs one of ten effects around the plate; under Plays, On event flashes it whenever time is added or taken away, so a marathon donation shows on the timer itself. How materials and effects work in every overlay is in Styling an Overlay. Every digit sits in a cell as wide as the widest digit of your font, so the timer does not jump sideways every second.
10. Press Save.

A marathon: donations add and take away time

Time changes on its own only on a countdown. The section is Adding and taking away.

1. In Donations, turn on Donations change the time and set the Price in your base currency, For a minute or an hour. Under the price the app shows the same price per hour, per minute and per second. Part of the price buys part of the time.
2. Words that add time and Words that take time away are comma-separated lists. A word counts anywhere in the message and in any letter case: «PLUS!», «!plus», «one more plus» all count.
3. Taking time away is one of three: Off: donations only add time, At the same price as adding or At its own price (Price of taking away). With it off, a donation with a minus word does not take time away and waits for your decision on the tile.
4. A donation without a word: Ask me on the control panel tile, Add time or Do not count it. A message with both words always waits for your decision on the tile.
5. Channel points: Add a reward, pick the Reward and set its Minutes. A negative number takes minutes away. Rewards are created in Channel Rewards.
6. Subscriptions: turn on Subscriptions add time and set the minutes per tier: Tier 1, minutes, Tier 2, minutes, Tier 3, minutes and Prime, minutes. A gifted subscription counts like a regular one of its tier, once for each person who got it.
7. In Limits and display, At most, hours left stops adding time at that much left; taking time away still works. Show changes next to the digits floats «+2:30» up when time is added, and With the viewer name adds who did it.

A donation you delete in Statistics gives back the time it added or took away.

The Timers: Control tile

Put the Timers: Control tile on the Control Panel. Timers that are on air in OBS come first, large, marked on air; the rest sit below under Not on air.

• The buttons depend on the timer. A stopwatch, a countdown of a set length and a count-up started by an event without Start over on every such event have all of them. A count-up that follows the clock (At a date and time, or an event with Start over on every such event) has none: it shows the time that has really passed, and there is nothing to start, add or reset. A countdown to a date has Reset, which takes it back to its date without the added time, and the minutes field only if donations with a price, rewards or subscriptions change its time.
• Start / Pause and Reset. Reset asks for a second press: the first turns the button into Sure? for three seconds.
• A count-up from a date and a countdown to a date show their date under the time, for example «From Sat, Sep 26, 06:00 PM», with a pencil. Press it, pick the day, hours and minutes, and press the check mark (Apply); the cross (Cancel) leaves the date as it was. The timer moves to the new date at once, and a countdown keeps the time donations added. If the date does not apply within ten seconds, the tile says The date did not apply. Check the timer in Widgets → Timers: the timer was changed or deleted while you were picking, or the Timers page is turned off.
• The field with + and − adds or takes away the minutes typed in it; Enter adds. A timer with a price has a min and currency switch next to the field: in money mode, the field adds time for an amount, counted at the price of that timer, as for a donation. Minutes and money keep separate numbers.
• Waiting for your decision lists donations with no word or with both words, with the nick, the amount and the message, and the buttons Add time, Take time away and Do not count.
• Time changes at the bottom: who changed the time, by how much and where it came from.
• The gear in the tile header opens Tile settings: which timers to show (All timers, Only the ones on air in OBS, Only the ones I pick) and whether to show Control buttons, Donations waiting for your decision and Feed of time changes, with Rows in the feed. Each tile keeps its own settings.

Zero in Scenarios

In Automation → Scenarios, the trigger Timer reached zero (Which timer) runs any step: a sound, an OBS scene switch. A countdown that keeps going below zero fires once, when it crosses zero. The step Timer (What to do) starts, pauses, resets, adds or takes away time, so a hotkey or a panel button can drive a timer. A timer does only what its buttons on the tile allow: a count-up from a date ignores the step. The one exception is adding or taking away time on a countdown to a date, which the step always does.

What it cannot do

• Time changes on its own only on a countdown. A count-up has no prices and no words.
• Donations that arrived while the app was closed do not change the time: the app did not see them.
• A donation in a currency with no exchange rate is not counted: there is nothing to compare it with.
• Kick subscriptions do not add time: Kick sends the app only rewards and chat.