Widgets/Producer

Clock Widget

Clock Widget

A "Producer" type widget. Clock Widget generates periodic events at specified time intervals. It acts as a timer that can trigger other widgets at regular intervals, providing a foundation for time-based operations in your recipes.

 

Inputs

  • Start (DataType: Anything) Any event arriving at this input will start the Clock Widget if it's not already running.

  • Stop (DataType: Anything) Any event arriving at this input will stop the clock if it's currently running.


Outputs

  • Output (DataType: Boolean) Outputs true at each interval specified in the settings. The interval timing begins when the clock is started.

Custom Settings

  • Interval — The time between each clock trigger, specified in milliseconds by default. Click on 'ms' to switch between milliseconds (ms) and seconds (sec) for the interval value.

Interval Mode Setting

 

Example

Basic Timer

This example shows a basic timer that triggers a Counter Widget every second, with the count displayed on screen.


Drag the example onto the workspace to explore and experiment!



In this example

  1. The Clock Widget generates events every 1 second (1000ms)
  2. The Counter Widget counts each clock event
  3. The Display Widget shows the current count value
  4. Two Button Widgets control the clock:
    • One button to start the clock
    • One button to stop the clock

Result: When you press the start button, the Clock Widget begins generating events every second. The counting continues until you press the stop button.

 

📌 Additional Notes

  • The Clock Widget state (running or stopped) persists when the recipe is saved
  • If the Clock Widget is enabled when the recipe is saved, it will automatically resume when the recipe is reloaded
  • The Clock Widget is implemented using JavaScript's timer functions, so the actual interval may vary slightly due to the event loop execution
  • Multiple Clock Widgets can be used in the same recipe with different intervals