Skip to content

Settings

Vivek Sarin edited this page Nov 18, 2026 · 4 revisions

Settings

FlowMotion has a settings page. To open it, select Settings, then FlowMotion in the list of plugins.

The settings apply to every diagram in your vault. A diagram can override some of them, as described below.

Autoplay

Autoplay is on by default. When it is on, a diagram starts as soon as it appears in a note.

Turn it off if you want the reader to start each diagram by hand. A single diagram can also turn off autoplay with %% @autoplay off or animation.autoplay: false. See Playback and timing.

Default speed

Default speed sets the speed of diagrams that do not set their own speed. You can choose 0.5×, 1×, or 2×.

A diagram can set its own speed with %% @speed (text format) or animation.speed (YAML format). The speed control in the playback bar can also change the speed while you watch.

draw.io background in light mode

draw.io background in light mode sets the sheet behind a draw.io drawing when Obsidian uses a light theme. The choices are:

  • White sheet, light colours. This is the default.
  • Dark sheet, dark colours.
  • No sheet.

draw.io background in dark mode

draw.io background in dark mode sets the sheet behind a draw.io drawing when Obsidian uses a dark theme. The choices are the same as above. The default is the dark sheet.

A diagram can override the background from its own toolbar, or with paper: in its src: block. See Appearance and backgrounds.

Playback controls

The Playback controls row explains the diagram-level controls; it has no toggle or dropdown. Controls are hidden by default. Select the gear button under a diagram to show them, or set controls: true in its block.

Optional add-ons

Both add-ons are desktop-only, off by default, and downloaded separately from the FlowMotion release.

Rich Code Editor (Monaco)

Monaco adds completion, hover help, and navigation in .flow files and the edit window.

  1. Open Settings, then FlowMotion.
  2. Turn on Rich Code Editor (Monaco).
  3. Wait for the installation notice.
  4. Reopen the diagram.

Installation requires internet access to download the pinned Monaco Editor package from npm. After installation, Monaco works offline. Without Monaco, CodeMirror provides YAML highlighting, formatting, and a live preview.

draw.io editor

FlowMotion downloads the editor from the draw.io releases on GitHub.

  1. Open Settings, then FlowMotion.
  2. Turn on draw.io editor.
  3. Wait for the notice the draw.io editor add-on is installed. You need a network connection once.
  4. Reopen the drawing.

The download is the current draw.war release, about 42 MB after FlowMotion keeps only the files the editor needs. The files go to <vault>/.obsidian/plugins/flowmotion/drawio/.

Turn on draw.io editor to create and edit .drawio.flow drawings on desktop. When it is off, opening a drawing shows an explanation instead of the editor. Existing drawings are not deleted.

Status and failures

The toggle row shows Status: installed. or Status: not installed. File-check failures show Status: unknown. and are logged to the developer console.

If the download fails, FlowMotion shows a notice with the reason and turns the toggle back off. Turn it on again to retry. Turning the toggle off removes the files.

Saved preferences

Preferences are saved in the plugin's data.json and restored when Obsidian restarts. Your preferences stay when you turn the draw.io add-on off. Only its files are deleted.

Related pages

Clone this wiki locally