// Video Embeds: https://github.com/requarks/wiki/discussions/4580
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.
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.
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:
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:
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:
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.
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 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
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.
For more information on this, please see the Overlay Action
This widget has access to the following commands: