DTG Countdown Timer for Live Streaming

This Streamer.bot extension allows streamers to have one or multiple countdown timers running simultaneously, counting down to a specific time. Customized with different labels, colors, and sizes to fit your stream's aesthetic. When a timer reaches zero, it can trigger a Streamer.bot action, allowing for seamless integration with your streaming setup.

How-To Incorporate the Countdown Timers Video Tutorial

<< VIDEO COMING SOON >>


Download from Ko-fi

You MUST have the WebSocket server enabled in Streamer.bot for this extension to work.


To enable the WebSocket Server, click on Servers/Clients, then WebSocket Server and ensure Auto Start WebSocket Server is checked (and if not already started, press Start Server).

Enabling the WebSocket Server in Streamer.bot

Setting up the Countdown Timers in Streamer.bot

In Streamer.bot click the Import button in the top menu. Drag the downloaded .mm file into the Import String field and click Import. You will see 6 Actions, and 5 CommandsImporting code for countdown timers to Streamer.bot

Once the extension is imported, navigate to the Commands tab, and scroll down to 'Mustached_Maniac Countdown Timer' and Right-Click on each of the 5 Commands and then press Enable

Enabling commands for countdown timers to Streamer.bot

Available Actions for the Countdown Timers Extension

  1. START
    • Moderators can start a timer with the Configurable Options using the !startcd command.
    • Note - If the label changes, it will be considered a new timer
  2. PAUSE
    • Moderators can pause a timer using the !pausecd command.
    • Note - an index number is NOT provided, it will pause the most recently started timer
  3. HIDE
    • Moderators can hide a timer using the !hidecd command.
    • Note - an index number is NOT provided, it will hide the most recently started timer
  4. SHOW
    • Moderators can show a timer using the !showcd command.
    • Note - an index number is NOT provided, it will show the most recently started timer
  5. STOP
    • Moderators can stop a timer using the !stopcd command.
    • *Note - an index number is NOT provided, it will stop the most
  6. Timer ENDED
    • This action is triggered automatically when a timer reaches zero OR a timer is manually stopped. You can customize this action to perform any tasks you want, such as sending a chat message, playing a sound, or triggering other actions in Streamer.bot. |Arguments Available | Value | Description| |--- | --- | ---| |%timerId% | 1 | Will be in the indexed number of the timer that ended (based on order started) | |%timerLabel% | New Year's Even | The label of the timer that ended | |%timerCompleted% | true | Whether the timer reached zero (true) or was stopped manually (false) | |%timerStopped% | false | Whether the timer was stopped manually (true) or reached zero (false) |

Use the above arguments in the 'Timer ENDED' action to customize your response based on which timer ended and how it ended.

Adding the DTG Countdown Timers to your broadcasting software

You can use the countdown timers straight out of the box and it will work just fine.

On your new Scene, Click on the Sources Tab and press the + to create a new Browser Source (name is irrelevant again)

Double-Click on your newly created Browser Source and edit the URL to the one provided

https://mustachedmaniac.com/widgets/DTG_Countdown_Timer

Congrats, you're ready to start using the DTG Countdown Timers!!

If you'd like to further customize it, use the tool below to tweak things like color options, alignment, etc.


When using the tool below, toggle a paramter to the On position, and then press the Update URL button to see a live preview. You can then copy the newly generated URL into your browser source to have the changes reflect on your version.


Customizing Countdown Timers to Match your Asthetic

There are several URL parameters that can be added to the end of the link above to customize the timers to your liking.

Special Note-The container has a white background and the font is white by default, to visibly see you changes, enable the 'Font Color' Option and select anything other then white

https://www.mustachedmaniac.com/widgets/DTG_Countdown_Timer

Live Preview


ParameterExampleDescription
host192.168.1.1Only needed if your Streamer.bot websocket address is NOT on 127.0.0.1
port8118Only needed if your Streamer.bot websocket port is NOT on 8080
endpoint"/stuff"Only needed if your Streamer.bot websocket endpoint is NOT on "/"
password"mYsEcReTp@$$w0rd"Only needed if you have authentication enabled on your Streamer.bot websocket
alignleftSet the text to be aligned to the left / center / right of the box (default to center)
fontRobotoAccepts system and Google fonts
fontColorredPick a different font color. Accepts names or hex values (defaults to white)
bg#000000Pick a different background color. Accepts names or hex values (defaults to no background/transparent)

© 2025 Mustached_Maniac. All rights reserved.