Mac OS Installation

Warning

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.

Warning

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.

Note

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

Warning

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

Warning

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.

Warning

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