The Persisent Timer Overlay Widget allows you to display a timer on your screen that continuously counts down, but can have time added back to it either via various events or dynamically via the Overlay Action. The time for the widget is continously tracked and will be saved when Mix It Up is shut down. This can be useful for things like stream-a-thons, especially ones that occur over multiple separate streams.

Previously there were two different types of timer-based Overlay Widgets, the Timer Overlay Widget and the Timer Train Overlay Widget. The functionality from both of these have now been combined into the Persistent Timer Overlay Widget. {.is-info}

For a Persistent Timer Overlay Widget, both an initial time amount and a maximum amount can be set to ensure the timer always starts with something and can not go higher than a specific value.

The Disable On Completion option will physically disable and hide the Persistent Timer Overlay Widget when the timer reaches 0.

The Reset On Enable option will reset the timer back to it’s initial amount when the Persistent Timer Overlay Widget is disabled or when the application is shutdown. For things like stream-a-thons, especially ones occurring over multiple streams it is recommended to disable this option.

The Allow Adjustment While Paused option allows time to be added and subtracted to the timer via events and dynamic changes via the Overlay Action.

Display Format

The Display Format option allows you to set how the timer itself will be shown as it changes over time. You can customize this by changing it to include specific values depending on how you want to show it. You can also include other text if you wish that is not part of the specific set of display format options. Below is a list of possible values you can use:

DD = The total number of days remaining as a cumulative amount
HH = The total number of hours remaining as a cumulative amount. If there are more than 24 hours remaining, it will show a value greater than 24. For example, if there are 36 hours remaining, this will show “36”.
hh = The total number of hours remaining after removing the number of days. If there are more than 24 hours remaining, it will only show the value remaining after days are subtracted. For example, if there are 36 hours remaining, this will show “12”.
MM = The total number of minutes remaining as a cumulative amount. If there are more than 60 minutes remaining, it will show a value greater than 60. For example, if there are 90 minutes remaining, this will show “90”.
mm = The total number of minutes remaining after removing the number of days & hours. If there are more than 60 minutes remaining, it will only show the value remaining after days & hours are subtracted. For example, if there are 90 minutes remaining, this will show “30”.
SS = The total number of seconds remaining as a cumulative amount. If there are more than 60 seconds remaining, it will show a value greater than 60. For example, if there are 90 seconds remaining, this will show “90”.
ss = The total number of seconds remaining after removing the number of days, hours, and minutes. If there are more than 60 seconds remaining, it will only show the value remaining after days, hours, minutes are subtracted. For example, if there are 90 seconds remaining, this will show “30”.

Let’s say you have a timer that has 2 days, 5 hours, 50 minutes, and 25 seconds remaining on it. Below are some examples of how that will be displayed with different format combinations:

“DD days hh:mm:ss” = “2 days 5:50:25”
“HH:mm:ss” = “53:50:25”
“HH:mm:ss” = “5:50:25”
“MM:ss” = “3230:25”
“mm:ss” = “50:25”
“SS” = “193825”
“ss” = “25”

Event Time Amounts

You can specify the amount of time in seconds that each event type adds to the timer. All of these events can be found towards the bottom of the editor. Each event type has one or both of the following progress amount types:

Additive Amounts

The time amount will be added to the timer each time that event occurs. For example, the Follow event uses the additive amount, meaning that exact amount will be added each time a follows occurs.

Multiplicative Amounts

The time amount will be multipled against the amount from the event. For example, the Donation event uses the multiplicative amount, meaning the amount donated will be multipled by the time amount. This will also include decimal values that are rounded if the donation currency supports it. A donation amount of $12.34 and an event value of 2 will add 25 seconds (12.34 * 2) to the goal.

Dynamic Timer Additions/Subtractions

Dynamic time can be added/subtracted from the timer by using the “Add To Timer” option on the Overlay Action. The amount specified will be directly added/subtracted to the timer when it is triggered. This can be useful for non-standard events, such as a Twitch Channel Point Reward that can add an amount to the timer.

For more information on this, please see the Overlay Action

Dynamic Timer Pausing

The Persistent Timer Overlay Widget can be paused and unpaused dynamically via the Overlay Action with the “Pause/Unpause Persistent TImer” option. While paused, the timer will not continue to count down.