Filter Stream Node

Filter incoming frames and conditionally let some through.


Use the Filter Stream Node to conditionally allow one or more frames to pass through to the downstream Nodes. This is typically used to selectively take snapshots, or save clips, or send webhooks when specific conditions are met.

Inputs & Outputs

  • Inputs : 1, Media Format : Raw Video
  • Outputs : Raw Video
  • Output Metadata : None


conditionAllow frames when this condition evaluates to true. If Duration specified, allow only for duration every time condition goes from false to true. Else allow while condition is true.

The trigger expression must be a valid Dot-notation expression that operates on Pipeline Metadata and evaluates to True or False. See details here.

ex. nodes.annotate_line_counter1.lines.line1.total_objects_crossed_delta > 0
intervalAllow frames periodically at this interval (seconds).
durationIf specified, allow frames through for this duration once every time the condition is True or at the specified Interval. Use 0 to allow only a single frame.


Metadata PropertyDescription