Command Line Launching¶

This page contains a series of terminal commands to open Vizard from the command line on macOS and provide optional arguments. Adjust the command line open command and file name according to your platform and how you named the Vizard application. The examples below it is assumed the application is called Vizard.app and it is installed in the syste /Applications folder.

To launch an instance of the Vizard application from the command line:

open /Applications/Vizard.app

The Vizard application supports the following command line arguments:

To launch Vizard application and automatically load a playback binary Vizard data file, use the -loadFile argument followed by the filepath:
```
open /Applications/Vizard.app --args -loadFile ~/filepath/filename.bin
```
To launch Vizard application in opNav mode, use the -opNav argument followed by the TCP address Vizard should connect to:
```
open /Applications/Vizard.app --args -opNav tcp://xxx.xxx.x.xx.xxxxx
```
To launch Vizard application in opNav mode without displaying anything to the screen, use the argument -batchmode with the -opNav argument:
```
open /Applications/Vizard.app --args -batchmode -opNav tcp://xxx.xxx.x.xx.xxxxx
```
To launch Vizard application with a livestreaming connection to BlackLion, use the -blackLion argument followed by the TCP address Vizard should connect to:
```
open /Applications/Vizard.app --args -blackLion tcp://xxx.xxx.x.xx:xxxxx
```
To launch Vizard application with a livestreaming connection to DirectComm, use the -directComm argument followed by the TCP address Vizard should connect to:
```
open /Applications/Vizard.app --args -directComm  tcp://xxx.xxx.x.xx:xxxxx
```
Note that here Vizard will show the scene being rendered which is helpful for debugging and demonstrations, but it will slow down the simulation.

To run Vizard cameras in a headless mode, use the -noDisplay argument instead.
To save a copy of all vizMessages passed to Vizard during the run, use the -saveMsgFile argument. Optionally, this argument can be followed by the desired file name that Vizard will name the saved message file on exit:
```
open /Applications/Vizard.app --args -saveMsgFile filenameToUse
```
To launch Vizard application and safe the rendering and image transmission times (in opNav mode) to the file ~/VizardData/opNavMetrics.txt, use:
```
open /Applications/Vizard.app --args -saveMetrics -opNav tcp://xxx.xxx.x.xx.xxxxx
```