Files
PhotonVision/docs/source/docs/advanced-installation/sw_install/mac-os.md
Sam Freund 9490c2f2cd Bump wpilib to 2026 beta (#2192)
## Description

<!-- What changed? Why? (the code + comments should speak for itself on
the "how") -->

<!-- Fun screenshots or a cool video or something are super helpful as
well. If this touches platform-specific behavior, this is where test
evidence should be collected. -->

<!-- Any issues this pull request closes or pull requests this
supersedes should be linked with `Closes #issuenumber`. -->

Bump to wpilib 2026 beta. This does not bump our pythonlib, as robotpy
hasn't come out yet.

## Meta

Merge checklist:
- [ ] Pull Request title is [short, imperative
summary](https://cbea.ms/git-commit/) of proposed changes
- [ ] The description documents the _what_ and _why_
- [ ] This PR has been
[linted](https://docs.photonvision.org/en/latest/docs/contributing/linting.html).
- [ ] If this PR changes behavior or adds a feature, user documentation
is updated
- [ ] If this PR touches photon-serde, all messages have been
regenerated and hashes have not changed unexpectedly
- [ ] If this PR touches configuration, this is backwards compatible
with settings back to v2025.3.2
- [ ] If this PR touches pipeline settings or anything related to data
exchange, the frontend typing is updated
- [ ] If this PR addresses a bug, a regression test for it is added

---------

Co-authored-by: Gold856 <117957790+Gold856@users.noreply.github.com>
2025-12-11 23:53:54 -06:00

2.0 KiB

Mac OS Installation

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

:::{note} You do not need to install PhotonVision on a Mac in order to access the webdashboard (assuming you are using an external coprocessor like a Raspberry Pi). :::

VERY Limited macOS support is available.

Installing Java

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

:::{warning} Using a JDK other than JDK17 will cause issues when running PhotonVision and is not supported. :::

Downloading the Latest Stable Release of PhotonVision

Go to the GitHub releases page and download the relevant .jar file for your coprocessor.

:::{note} If you have an M Series Mac, download the macarm64.jar file.

If you have an Intel based Mac, download the macx64.jar file. :::

:::{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 unlikely any streams will open from real webcams. :::