Repository navigation
Flow Actions
Home · Triggers · Conditions
Actions are the Then part of a Flow. Each action operates on the type named on its card. Use the same name in related cards; the selected picker value takes precedence over a name entered in the text field.
Browse the Actions index for a dedicated page for every current action card.
| Action | What happens |
|---|---|
| Start or replace stopwatch, timer or transition | Starts a new chronograph. An existing chronograph of the same type and name is replaced. |
| Resume stopwatch, Resume timer, or Resume transition | Resumes a paused matching chronograph; leaves a running one running. Reports an error if none exists. |
| Start or resume stopwatch, timer or transition | Starts it if absent, resumes it if paused, and leaves it running if already running. |
Stopwatch start actions need only a name. Timer start actions need a duration and unit. Transition start actions need a duration and unit, start value, end value and a step count of at least two. The app limits the effective step count for short durations. See transition steps for an example that applies the values to a device.
Example — restart a countdown: When motion is detected, use Start or
replace timer for Hall light with a duration of 5 minutes. A separate
finished-trigger Flow turns off the light. Each new detection replaces the
countdown.
Example — continue instead: Use Start or resume timer when you want a paused timer to continue from where it was, rather than restart. Its duration is used when a new timer is created, not to reset an existing timer. The supplied parameters must still be valid even when resuming an existing timer or transition.
Example — measure a workout: Start a stopwatch named Workout when the
activity begins. Use Get the elapsed duration of a stopwatch before stopping
it to include its elapsed time in a notification. You can also save a
Stopwatch reached a duration Flow before starting it to give a reminder.
| Action | What happens |
|---|---|
| Pause | Pauses a running stopwatch, timer or transition. |
| Adjust | Adds the specified amount to elapsed time; a negative amount subtracts it. Elapsed time cannot go below zero. |
| Stop | Removes the named stopwatch, timer or transition. |
| Stop all | Stops all chronographs of that type. |
Pause, adjust, stop and resume-existing support wildcard names in the name field. Check the card's hint for details. A named operation can report an error when the chronograph does not exist.
Adjust changes elapsed time, not the target duration. For a timer, adding 2 minutes to elapsed time makes it finish 2 minutes sooner; subtracting 2 minutes gives it up to 2 extra minutes, subject to the zero-elapsed limit. For a stopwatch or transition, a positive adjustment moves the elapsed reading forward and a negative one moves it backward.
Example — give a timer more time: Adjust Oven by -2 minutes. If at
least 2 minutes have elapsed, its remaining time increases by 2 minutes.
Each type has a Get the duration action. It returns Flow tokens for the named existing chronograph:
- Stopwatches expose elapsed duration.
- Timers expose remaining and elapsed durations.
- Transitions expose remaining and elapsed durations.
- Values include milliseconds, converted seconds/minutes/hours and formatted time strings. The General settings tab controls the decimal places used for converted Flow-card values.
Use the action's output tokens in later steps, for example to send a notification showing how long a stopwatch has been running. The card reports an error if the requested chronograph does not exist.
The current start, start-or-resume and adjust duration fields accept numeric expressions and Flow tokens. See MathJS expressions in Flow cards. Some Flow fields are also marked BLL supported; see BLL coding for syntax and examples.
Support development - If Chronograph is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!