capture config
==============

The capture configuration file is typically stored under ``~/.macs/capture.json`` and contains several parameters about the current capture configuration.
It may look like the following:

.. literalinclude:: ../../configs/capture_example.json
   :language: json

Which contains the two most important entries, namely the :doc:`../roc/rocbroker` address an the connected cameras.
Furthermore, ``storageLocations`` defines a list of filesystem locations, where captured data may be stored and ``mount`` defines how the scanning mount is connected to the computer.
More configuration examples can be found in the ``configs`` directory of the sourcecode repository.

:note: It is well possible, to have different configuration files on multiple computers connecting to the same broker. If e.g. there are two computers with different cameras connected, the capturing computers should list only their own cameras while the operator computer can list all of them.

The configuration file will be read by all programs participating in the acquisition system, each progam uses only the parts of the file which are sensible to it.