Filesystem Source

The filesystem source is a source node — the entry point of a pipeline. Instead of processing a media item, it enumerates media from disk (a directory tree walked recursively, or a set of path globs) and feeds each file into the graph.

Kind

filesystem-source

Applies to

— (source node; produces the media stream)

Inputs

None — it is the root of the DAG

Output keys

path, source (= filesystem) for the item currently flowing through the graph

Requirements

CPU only, but the worker must be able to read the media path — the shared media mount has to be visible to the process.

Persists to

n/a (source)

A pipeline has exactly one source node. When Loom dispatches a source task, this node runs on the chosen worker and streams discovered items back; path discovery lives in FilesystemMediaScanner.

Configuration

FilesystemSourceNodeOptions:

Option Meaning

path

Root directory to walk recursively

pathGlobs

A set of path globs (take precedence over path when both are set)

Values from the pipeline definition win; the option defaults are used when the definition supplies no selection.

Use Cases

  • Folder / NAS ingest — scan a storage location for new media to process.

  • Targeted runs — process only files matching specific globs.