Desktop integration | Flomation Support

00Overview

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Desktop

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
Authentication	`string`	Required	Private Key, Passwor
SSH Private Key	`secret`		${secrets.DesktopVMKey}
Key Passphrase	`secret`
Password	`secret`
Host	`string`	Required	10.0.0.5
Port	`integer`		22
Username	`string`	Required
Host Key Fingerprint	`string`		SHA256:… (optional but recommended)

Good to know

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Click

Desktop Click

desktop/click · Action

Move the mouse to (x, y) on a desktop VM and click a button.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0
X	`integer`	Required
Y	`integer`	Required
Button	`string`		choices: Left, Right, Middle
Clicks (1 = single, 2 = double)	`integer`		1
Focus Window First (title substring, optional)	`string`		Google Chrome
Settle After (ms)	`integer`		300

Returns: tool_result, success, error

03Focus

Desktop Focus Window

desktop/focus_window · Action

Raise and focus a window on a desktop VM by title, so the next click or keypress targets it.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0
Window Title (substring match)	`string`	Required	Google Chrome

Returns: tool_result, success, error

04Key

Desktop Press Key

desktop/key · Action

Press a key or chord on a desktop VM (e.g. Return, ctrl+c / ^c).

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0
Key(s)	`string`	Required	Linux: Return, ctrl+c · Windows: {ENTER}, ^c
Focus Window First (title substring, optional)	`string`		Google Chrome
Settle After (ms)	`integer`		300

Returns: tool_result, success, error

05List

Desktop List Recordings

desktop/list_recordings · Action

List the ids of screen recordings currently running on a desktop VM.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0

Returns: tool_result, recordings, count, success, error

06Move

Desktop Move Mouse

desktop/move · Action

Move the mouse pointer to (x, y) on a desktop VM without clicking.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0
X	`integer`	Required
Y	`integer`	Required

Returns: tool_result, success, error

07Open

Desktop Open URL

desktop/open_url · Action

Open a URL in the default browser on a desktop VM.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0
URL	`string`	Required	https://www.flomation.co
Navigate the current tab (instead of opening a new one)	`boolean`
Browser Window (title substring, used with Navigate current tab)	`string`		Google Chrome
Settle After (ms)	`integer`		1500

Returns: tool_result, success, error

08Record

Desktop Start Recording

desktop/record_start · Action

Start recording the screen of a desktop VM (ffmpeg). Stop with Desktop Stop Recording.

Field	Type	Details
Operating System	`string`	choices: Linux, Windows
X Display (Linux)	`string`	:0
Frame Rate	`integer`	15

Returns: tool_result, recording_id, success, error

Desktop Stop Recording

desktop/record_stop · Action

Stop a desktop VM screen recording and return the video file.

Field	Type	Details
Operating System	`string`	choices: Linux, Windows
X Display (Linux)	`string`	:0
Recording ID — the id from Desktop Start Recording. Leave blank to stop the most recent recording.	`string`	${recording_id}

Returns: tool_result, video, recording_id, size_bytes, success, error

09Run

Desktop Run Command

desktop/run_command · Action

Run a shell command on a desktop VM (targets the desktop session) and return its output.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0
Command	`text`	Required	wget -qO /tmp/bg.png https://… && xfconf-query -c xfce4-desktop -p …

Returns: tool_result, stdout, stderr, exit_code, success, error

10Screen

Desktop Screen Info

desktop/screen_info · Action

Report a desktop VM's screen size and active window, and whether screenshot coordinates match.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0

Returns: tool_result, width, height, active_window, coordinates_match_screenshot, coordinate_multiplier, success, error

11Screenshot

Desktop Screenshot

desktop/screenshot · Action

Capture the screen of a desktop VM over SSH and return the image.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0

Returns: tool_result, image, size_bytes, success, error

12Scroll

Desktop Scroll

desktop/scroll · Action

Scroll the mouse wheel up or down on a desktop VM.

Field	Type	Details
Operating System	`string`	choices: Linux, Windows
X Display (Linux)	`string`	:0
Direction	`string`	choices: Down, Up
Notches	`integer`	3
X (point at the area to scroll)	`integer`
Y (point at the area to scroll)	`integer`
Focus Window First (title substring, optional)	`string`	Google Chrome
Settle After (ms)	`integer`	300

Returns: tool_result, success, error

13Type

Desktop Type Text

desktop/type_text · Action

Type literal text into the focused window on a desktop VM.

Field	Type		Details
Operating System	`string`		choices: Linux, Windows
X Display (Linux)	`string`		:0
Text	`text`	Required	Text to type into the focused field
Focus Window First (title substring, optional)	`string`		Google Chrome
Press Enter after typing (e.g. to run a typed command)	`boolean`
Settle After (ms)	`integer`		300

Returns: tool_result, success, error