Skip to content

Playback and Timing

Vivek Sarin edited this page Nov 20, 2026 · 2 revisions

Playback and timing

This page explains how to play, pause, and control a diagram, and how to set the timing of each step.

Play and pause

  • In ordinary playback, click the diagram to play or pause it.
  • Diagrams normally start automatically. To change this, turn off Autoplay in the FlowMotion settings. The YAML format also lets a single diagram opt out. Interactive mode waits for Next instead.

Playback controls

Select the ⚙ button in a diagram's toolbar to show the playback controls. Select it again to hide them. These controls are hidden by default. The toolbar also includes SVG ↓ for animated export and, in interactive mode, Next.

Control What it does
▶ / ⏸ Plays or pauses the diagram
⏮ Steps back to the previous event
⏭ Steps forward to the next event
⏹ Returns the diagram to its starting state
↻ Plays the diagram again from the beginning
Timeline Moves to any point in the animation
Speed Sets the speed to 0.25×, 0.5×, 1×, 2×, or 4×

To show the controls every time, add controls: true to the diagram block. See Reusing diagrams for the other display options.

Interactive playback

Add interactive: true to a storyboard or its src: block to wait for a button press before each beat:

```flowmotion
src: ./story.flow
interactive: true
```

Select Next to play one beat and pause at the next beat boundary. The next beat's initial appearance and caption can appear at that boundary, but its animation waits for the next click. For other diagrams, Next plays to the next event boundary. Open the playback controls to reset or seek. Interactive mode does not autoplay or loop. With reduced motion enabled, Next jumps to the boundary instead of animating.

All edges in one storyboard beat animate together. The final beat includes the playback tail. Next replaces continuous Play/Replay in interactive mode; the step buttons still move through event boundaries. See the authoring reference for exact behavior.

Animated SVG downloads do not contain interactive controls or pauses. See Exporting diagrams.

Timing and playback settings

For text DSL diagrams, use the comments below. A comment starts with %%, so other tools ignore it. Event YAML uses duration and animation.speed; storyboards use ms and top-level speed (beat duration, not a multiplier).

Comment Effect
%% @duration <node> <ms> Sets how long a node takes to process, in milliseconds
%% @fail <node> Shows the node in an error state
%% @speed <n> Sets the overall playback speed
%% @loop off Plays the diagram once instead of repeating it
%% @autoplay off Stops the diagram from starting automatically

Example:

%% @duration db 700
%% @fail payment
%% @speed 0.5
%% @loop off

Default speed

Open Settings, then FlowMotion, and choose Default speed. The default speed applies to every diagram that does not set its own speed.

How a diagram plays

  • Each arrow shows a packet that moves along it.
  • Each node processes its input, then passes on its output.
  • A node with several inputs waits until all of its inputs arrive.
  • Diagrams that repeat start again after they finish. Use %% @loop off to stop them after one run.

Reduced motion

If your computer is set to reduce motion, FlowMotion shows the finished diagram and does not start it on its own. To watch the animation, show the playback controls and select ↻ Replay. Interactive playback instead starts at the beginning and advances without animation.

To change this behaviour, turn off the reduce-motion option in your operating system's accessibility settings.

Notes

  • Feedback loops are drawn, but they animate only once.
  • For the screen modes (Fit, Normal, and Full screen), see Appearance and backgrounds.

Clone this wiki locally