Skip to main content
Category: Controls · Sends commands: on complete · Reads data: no

​
Mental model

A Countdown Timer is an egg timer. Set a duration, it counts down, and when it hits zero it can do something — notify, play a sound, or fire a command.

​
When to use it

  • Time-boxed actions (run a pump for 5 minutes, then stop)
  • Visible countdowns with a completion event

​
Settings

​
General

  • Initial duration — hours / minutes / seconds
  • Auto start · show controls
  • Show progress bar · progress color · show milliseconds

​
Behavior on complete

  • Execute action on complete — fire a command at zero
  • Show notification — title + message
  • Play sound · sound URL

​
Style

Background, border, text/icon color, container.

​
Triggers

EventFires when
completeThe timer reaches zero
start / pause / resetTimer controls
(common)load, ready, destroy, update, visible, hidden

​
Example — stop a device when time’s up

WHEN     complete
SEND TO  Current Device
EXECUTE  Operate
Action   OFF   params: {}

​
Script API example

The same interactions from a dashboard script: 
widget.on('runTimer', 'complete', () => {
  ws.send(context.deviceId, { command: 'Operate', action: 'OFF' });
  widget.setText('timerStatus', 'Finished');
});

Schedule Manager

For recurring, clock-based automation instead of a one-off countdown.