Wait for template

AutomationConfigured target requiredtemplate.wait

Capture fresh frames from an exact window until the template appears or time expires.

Example use

Wait for a "Loading complete" template before continuing automation.

Node preview

Right-drag to pan and scroll to zoom. Expand inputs and edit parameters to see how ports change. This preview does not run the node; reopening the page restores the example.

Loading node preview…

Data inputs 6

Template imagetemplateImage: Durable template image to wait for.
RequiredDefault: None
Search regionregionRegion: Region of the captured window to search.
Default availableDefault: {"height":1,"unit":"ratio","width":1,"x":0,"y":0}
Value format examples
{"height":0.5,"unit":"ratio","width":0.5,"x":0.25,"y":0.25}
Match thresholdthresholdNumber: Score from 0 to 1 required to report a match.
Default availableDefault: 0.85
Wait timeouttimeoutDuration (milliseconds) · ms: Maximum wait in milliseconds; 0 checks one frame.
Default availableDefault: 5000
Minimum: 0
Maximum: 86400000
Value format examples
1000
Poll intervalpoll-intervalDuration (milliseconds) · ms: Milliseconds between fresh frame checks.
Default availableDefault: 100
Minimum: 0
Maximum: 86400000
Value format examples
1000
Settle durationsettle-durationDuration (milliseconds) · ms: Milliseconds to wait and confirm again with a fresh frame after the first match.
Default availableDefault: 0
Minimum: 0
Maximum: 86400000
Value format examples
1000

Configuration 1

Window target slotslotText: Select a target bound to an application path, window title, and window class.
RequiredDefault: None
Minimum characters: 1
Maximum characters: 128
Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$

Data outputs 4

MatchedmatchedBoolean: Whether the template met the threshold in the final frame.
Match scorescoreNumber: Template score from the final frame.
CentercenterPoint: Pixel center of the matched bounds in the capture.
Value format examples
{"unit":"ratio","x":0.5,"y":0.5}
{"unit":"px","x":640,"y":360}
Matched boundsboundsRegion: Pixel bounds of the match in the capture.
Value format examples
{"height":0.5,"unit":"ratio","width":0.5,"x":0.25,"y":0.25}

Control and error ports

InputinInput · Control: An incoming control signal enters this operation.
FoundfoundOutput · Control: Continue from this result or stage; see the node description for branch conditions.
TimeouttimeoutOutput · Control: Continue from this result or stage; see the node description for branch conditions.
FailedfailedOutput · Error: Emitted when the operation fails; connect error handling here.

Version and node identity

Version 1.2.0

sha256:8fd5356026b4f1e5a6d87e3627fab7374876e4e4fe9fe39ff247dcd090cc13f7