Mac OS Installation


Due to current cscore restrictions, the PhotonVision server backend may have issues running macOS.

VERY Limited macOS support is available.

Installing Java

PhotonVision requires a JDK installed and on the system path. JDK 11 is needed (different versions will not work). You may already have this if you have installed WPILib. If not, download and install it from here.


Using a JDK other than JDK11 will cause issues when running PhotonVision and is not supported.

Downloading the Latest Stable Release of PhotonVision

Download the latest stable .jar of PhotonVision from the GitHub releases page.


Be sure not to download the .jar file with “-raspi” at the end as that is specifically meant for Raspberry Pi coprocessors.


Be careful to pick the latest stable release. “Draft” or “Pre-Release” versions are not stable and often have bugs.

Running PhotonVision

To run PhotonVision, open a terminal window of your choice and run the following command:

$ java -jar /path/to/photonvision/photonvision-xxx.jar


Due to current cscore restrictions, the PhotonVision using test mode is all that is known to work currently.

Accessing the PhotonVision Interface

Once the Java backend is up and running, you can access the main vision interface by navigating to localhost:5800 inside your browser.


Due to current cscore restrictions, it is unlikley any streams will open from real webcams.