# homebrew-atomicxr

Homebrew tap for XR applications on Fedora Atomic

## Install ##

Tap:
```sh
brew tap matrixfurry.com/atomicxr https://tangled.org/@matrixfurry.com/homebrew-atomicxr
```

Formulae (`brew install <application>`):
- [AtomicXR CLI (`axr`)](https://tangled.sh/@matrixfurry.com/atomic-xr): `atomicxr-cli`
- [WlxOverlay-S](https://github.com/galister/wlx-overlay-s): `wlx-overlay-s`
- [Monado Tracking Origin Calibrator](https://github.com/galister/motoc): `motoc`
- [OSC Avatar Manager](https://github.com/galister/oscavmgr): `oscavmgr`
- [VrcAdvert](https://github.com/galister/VrcAdvert): `vrc-advert`
- [Index Camera Passthrough](https://github.com/yshui/index_camera_passthrough): `index-camera-passthrough`

Casks (`brew install --cask <application>`):
- [WayVR Dashboard](https://github.com/olekolek1000/wayvr-dashboard): `wayvr-dashboard`
- [LÖVR Playspace](https://github.com/SpookySkeletons/lovr-playspace): `lovr-playspace`

## Performance ##
If you want slightly better runtime CPU performance, you can build from source using `brew install --build-from-source <application>`

All Bottles are built for `x86_64-v3`, which should be a good balance between performance and compatibility.

## Troubleshooting ##

### Formulae found in multiple taps
If you had this tap or AtomicXR installed before Aug 10, 2025, you might see an error message like:
```
Error: Formulae found in multiple taps:
       * shiloh/atomicxr/atomicxr-cli
       * matrixfurry.com/atomicxr/atomicxr-cli
```

To resolve this, remove the old tap with `brew untap shiloh/atomicxr`

### WayVR Dashboard: `xkbcommon: ERROR: failed to add default include path /home/linuxbrew/.linuxbrew/share/X11/xkb`
This happens when the `xkb` config files (from the `xkeyboard-config` formula) are not linked to
`/home/linuxbrew/.linuxbrew/share/X11/xkb`. This will happen if the `xorg-server` formula is installed.

To fix this, run `brew unlink xkeyboard-config; brew link xkeyboard-config --overwrite`

### Issues with `pthread.h` or other fixincludes while building formulae
This is caused by using Homebrew's GCC instead of Fedora's. Make sure Homebrew GCC is uninstalled and not a dependency.

## Security ##

Please see the [Security Policy](./docs/security.md)