Homebrew#

Homebrew is “The Package Manager for Everywhere”. It can be installed on almost any Linux distro. See this page for more info about Support Tiers.

Homebrew-XR is the tap containing VR and AR software.

Setup#

This one-line installer will automatically set up Homebrew and Homebrew-XR for you.

bash -c "$(curl -fsSL https://tangled.org/did:plc:tnpscg53k2nexylmouhv4b5e/raw/main/scripts/setup.sh)"

  1. If you don’t already have Homebrew, run the setup script:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. Add the Homebrew-XR Tap:

    brew tap homebrew-xr https://tangled.org/did:plc:tnpscg53k2nexylmouhv4b5e

Installing Applications#

To install software from Homebrew, just run brew install <package>.

You can view a list of all available packages in Homebrew-XR with: brew search /xr\//.

You can install the latest development version of a package with brew install --head <package>

Common setups#

Runtimes (please read the post-install instructions):

  • For wired headsets, you’ll need to install Envision, Monado, and XRizer: brew install envision monado xrizer
  • For wireless headsets, you can install WiVRn via Flatpak (see this issue for the status of packaging WiVRn in Homebrew-XR)

Plugins & Overlays (can be enabled in Envision or WiVRn settings):

  • For desktop access or launching your games & apps, you’ll probably want WayVR: brew install wayvr
  • For a playspace boundary, you can use LÖVR Playspace: brew install lovr-playspace
  • For a face & eye tracking relay (VRCFT replacement), see OSC Avatar Manager: brew install oscavmgr
  • Most other software listed on this wiki is packaged in Homebrew-XR, you can search for it with brew search <name>

Support & Updates#

You can report issues on Tangled, ask questions in this post on the LVRA Discord (link in the community tab), or reach out to the maintainer directly.

You can view or subscribe to announcements on Leaflet, or using the Homebrew-XR role in Discord.