DYNAMIC TIMERS

5.0(6)

A refined take on classic OBS timer widgets — fully controllable, supporting multiple timers, with custom triggers for actions when timers start or end. Compatible with Twitch & YouTube.

As many fully controllable timers as you need in one overlay
Commands and custom triggers for full control
Flexible time input formats (seconds, timestamps, timecodes)
Fully customizable

Quick Access

Copy what you need to get started. Follow the setup guide below for detailed instructions.

Browser Source URL

Add this as a browser source to OBS.

https://tawmae.xyz/overlays/dynamic-timers-v2

Action Import String

Import the actions into Streamer.bot.

Loading…

Setup Guide

Copy the Action Import String

Copy the Action Import text from Quick Access.

Import into Streamer.bot

In Streamer.bot, click the Import button at the top of the window. Paste the text into the Import String section and press Import at the bottom.

Enable the Commands

Open the Commands tab. Find the imported group. Right-click the group and click Enable All.

Open the Settings UI once and hit Save

Open the action [DYNAMIC TIMERS] #0 - Settings. Right-click the Test trigger and hit Test Trigger. Click Save.

If the TawmaeUI.dll is missing, you'll be asked to auto-download. That popup window may appear behind the Streamer.bot window, so make sure to check if nothing appears.

Start WebSocket Server

Go to the tab Servers/Clients → WebSocket Server. Enable Auto Start WebSocket Server. Address 127.0.0.1. Port 8080. Optional password. Leave Enforce All Requests unchecked. Start the server.

Copy Browser Source URL

Copy the Browser Source URL from Quick Access.

Add Browser Source in OBS

In OBS, create a new Browser Source, name it whatever you want. Then paste the copied URL into URL and preferably set the Width and Height to your OBS canvas size.

If you want to have the browser source in multiple scenes, don't create a second browser source. Instead, use nested scenes or source clones.

Done!

And you are done! You can now test trigger the [DYNAMIC TIMERS] 1 - Add Time action to create your first test timer. In the FAQ, you can check what the individual arguments do and how to create timers with a channel reward as an example.

Commands

Command	Permission	Description	Example
!createTimer <Time> \| <Title> \| <Description> \| <CountUp=true>	Mods Only	Create the timer. The time is required, the rest is optional. Time value can be a number for seconds, or something like '5min', '60s', '1h' or '05:00'. Options separated by pipe symbols.	!createTimer 5min \| AFK \| Be right back
!pauseTimer <Title>	Mods Only	Pause the timer specified by title.	!pauseTimer AFK
!resumeTimer <Title>	Mods Only	Resumes the timer specified by title.	!resumeTimer AFK
!addTime <Time> \| <Title>	Mods Only	Add time to the specified timer. The Time value supports the same formats as !createTimer. Time and title separated by a pipe symbol.	!addTime 2min \| AFK
!removeTime <Time> \| <Title>	Mods Only	Remove time from the specified timer. The Time value supports the same formats as !createTimer. Time and title separated by a pipe symbol.	!removeTime 2min \| AFK
!deleteTimer <Title>	Mods Only	Delete the timer specified by title.	!deleteTimer AFK

Settings UI

Appearance

Customize the appearance to your liking.

Timer Format
Pick the default timer format for all your timers. Note: You can always use custom arguments to overwrite specific timers with other formats. See FAQ for more.
Font
The font for the timer title and description.
Timer Font
The font for the actual timer. It has to be monospace, so it can't be a regular font like title and description.
Font Color
The color of your font.
Background Color
The color of the background of each timer.
Background Transparency
The transparency of the timer's background. If set to '0', it will also remove the border.
Rounded Corners
Choose whether the background has rounded corners or not.
Zoom Level
Make the elements bigger or smaller. For the love of god, please do not manually scale the browser source in OBS :(
Default Icon
Choose the icon that is applied to each timer by default. It can be any icon notation from icones.js or you straight up use any image URL. Note: You can overwrite the icon for each timer with arguments, and also hide icons entirely. See FAQ for more.

Chat Responses

Edit chat responses. Use a single hyphen to skip a message. Allows to use variables that are listed below each textbox. Reset to default by clicking the icon on the right.

Custom Triggers

Timer Created

Fires when a new timer is created.

Variable	Type	Description	Example
%timerName%	string	The title of the timer.	AFK
%timerDescription%	string	The description of the timer.	I will be right back!
%timerValue%	int	The initial time value in seconds.	120
%currentValue%	int	The current time value in seconds.	60
%totalValue%	int	The total time value in seconds.	180
%countUp%	bool	Flag whether the timer is a stopwatch or not.	false
%timeAdded%	int	Time value if time has been added. 0 for everything except for 'Time Added' events.	30

Time Added

Fires when time is added to an existing timer.

Variable	Type	Description	Example
%timerName%	string	The title of the timer.	AFK
%timerDescription%	string	The description of the timer.	I will be right back!
%timerValue%	int	The initial time value in seconds.	120
%currentValue%	int	The current time value in seconds.	60
%totalValue%	int	The total time value in seconds.	180
%countUp%	bool	Flag whether the timer is a stopwatch or not.	false
%timeAdded%	int	Time value if time has been added. 0 for everything except for 'Time Added' events.	30

Timer Paused

Fires when a timer is paused.

Variable	Type	Description	Example
%timerName%	string	The title of the timer.	AFK
%timerDescription%	string	The description of the timer.	I will be right back!
%timerValue%	int	The initial time value in seconds.	120
%currentValue%	int	The current time value in seconds.	60
%totalValue%	int	The total time value in seconds.	180
%countUp%	bool	Flag whether the timer is a stopwatch or not.	false
%timeAdded%	int	Time value if time has been added. 0 for everything except for 'Time Added' events.	30

Timer Resumed

Fires when a timer is resumed.

Variable	Type	Description	Example
%timerName%	string	The title of the timer.	AFK
%timerDescription%	string	The description of the timer.	I will be right back!
%timerValue%	int	The initial time value in seconds.	120
%currentValue%	int	The current time value in seconds.	60
%totalValue%	int	The total time value in seconds.	180
%countUp%	bool	Flag whether the timer is a stopwatch or not.	false
%timeAdded%	int	Time value if time has been added. 0 for everything except for 'Time Added' events.	30

Timer Ended

Fires when a timer ends.

Variable	Type	Description	Example
%timerName%	string	The title of the timer.	AFK
%timerDescription%	string	The description of the timer.	I will be right back!
%timerValue%	int	The initial time value in seconds.	120
%currentValue%	int	The current time value in seconds.	60
%totalValue%	int	The total time value in seconds.	180
%countUp%	bool	Flag whether the timer is a stopwatch or not.	false
%timeAdded%	int	Time value if time has been added. 0 for everything except for 'Time Added' events.	30

Timer Removed

Fires when a timer is removed.

Variable	Type	Description	Example
%timerName%	string	The title of the timer.	AFK
%timerDescription%	string	The description of the timer.	I will be right back!
%timerValue%	int	The initial time value in seconds.	120
%currentValue%	int	The current time value in seconds.	60
%totalValue%	int	The total time value in seconds.	180
%countUp%	bool	Flag whether the timer is a stopwatch or not.	false
%timeAdded%	int	Time value if time has been added. 0 for everything except for 'Time Added' events.	30

FAQ & Examples

Is there no 'Create Timer' action anymore?

No. It has been merged with the action to Add Time. When you add time to a non-existent timer, it will now create it. And if you add time to an already existing timer, it'll add it on top. Makes it easier to stack timers for rewards.

What are the invidual arguments in the 'Add Time' action doing?

timerValue: This one is mandatory and is the time added/initial creation time. It can be a number like 60 or straight up a format like 15min, 1h or 05:00

timerName: This is the title of your timer. It's optional, so it can be left disabled/deleted, but will then default to a generic name like Timer 1

timerDescription: This is the description of your timer. It's optional, so it can be disabled/deleted and will then have no description at all.

countUp: This is a bool that can either be set to True or False and will determine whether the created timer goes up or down. If it goes up, it always starts at 00:00:00. It's optional, so it can be disabled/deleted.

timerIconOrImage: By default, all timers use the default icon you've set in the Settings UI. You can however overwrite icons for individual timers by entering the icon or image URL straight in there. It's optional and can be disabled/deleted.

hideIcon: This is a bool that can either be set to True or False and will hide the icon entirely for this specific timer. It's optional and can be disabled/deleted.

timeFormatOverwrite: By default, timers use the time format specified in the Settings UI. You can however overwrite it for specific timers by entering the new format like mm:ss:ms. It's optional and can be disabled/deleted.

General Note: If you use any of the commands shipped with the extension, all arguments are ignored entirely. With the commands, you can only set time value, title, description and the count up bool. The format can be seen in the Commands section above.

How can I create a timer with other triggers, like a Channel Reward?

In general, if we don't use commands like !createTimer to create a timer, we use all the arguments that are within the Variables group in orange. So we do that for the channel reward as well.

Because we most likely want to create multiple timers in the future, we first go into the action [DYNAMIC TIMERS] 1 - Add Time and disable the entire Variables group. Otherwise it would always overwrite our other settings once we run that action.

We then create a new action, give it any name and create your reward trigger and select your reward: Twitch -> Channel Reward -> Reward Redemption

Now copy the Variables group over to the new action and enable it again. Then add a Core -> Actions -> Run Action subaction and select the action [DYNAMIC TIMERS] 1 - Add Time.

You can now customize all the arguments to your liking! And whenver someone redeems the reward, it will create the timer, or, if it already exists, add time to it!

What happens to running timers if I close OBS?

Timers are saved locally in the Browser Source. So it the browser source isn't active, the timers will save their state and continue where you left off once they become active again.

Can I clear all timers at once?

Yes. Hit Interact in OBS when selecting your Browser Source and then hit the ESC key.