Skip to content

Vision Node command line execution

The Vision Node can be executed via command line, either to run as a daemon or to perform single-shot processing of video files.

Running with -h gives a list of the options:

$ /opt/broox/BrooxVisionNode/BrooxVisionNode -h

Usage: BrooxVisionNode [options]

Options:
  -h, --help            show this help message and exit
  -c VISIONNODE_INI_PATH, --config=VISIONNODE_INI_PATH
                        Location of the visionnode.ini file
  -l LOGFILE, --logfile=LOGFILE
                        Location for logfile
  -p PIDFILE, --pidfile=PIDFILE
                        Location of the pid file
  -d, --daemon          Run without GUI, for daemon or CLI usage
  -w, --webservice      Start streaming and configuration web
  -A, --noanalytics     Disable analytics messages output via mqtt
  -i, --interactive     Start interactive viewer (daemon mode only)
  -o OUTPUT, --output=OUTPUT
                        Output interactive snaps to given path as numbered
                        .png files
  -s STAGE_STATS, --stage-stats=STAGE_STATS
                        Output stage stats on end to the given json file
  -n, --noconfig        Do not try to load configuration from the controller
                        (daemon mode only)
  -f INFILE, --infile=INFILE
                        Override input video url (daemon mode only)
  -D DUMPFILE, --dump=DUMPFILE
                        Dump all output triggers to file for debug
  -P PIPELINE, --pipeline=PIPELINE
                        Override ini selected pipeline (daemon mode only)
  -b, --blur-faces      Anonymize faces by blurring them

CLI execution

By default, BrooxVisionNode will start its UI. Using the -d option disables the UI and starts the processing part immediately. Using the -i option displays the preview image during the processing.

Example:

BrooxVisionNode -d -c visionnode.ini will start the Vision Node with the given .ini file but no interactive/UI, as used for daemon execution.

BrooxVisionNode -d -i -c visionnode.ini will start the Vision Node with an interactive preview.

BrooxVisionNode -n -d -i -c visionnode.ini will start the Vision Node with an interactive preview BUT without connecting to the Broox Controller. This is useful for processing video.

Processing video

Using the -f /path/to/input/file.mp4 allows a single shot processing of a video file.

Example:

BrooxVisionNode -d -f /tmp/video.mp4 -P audience-analytics-medium -D dump.txt to process a video and output all generated detections to a text file.