Fedora Atomic#

This documentation applies to both Fedora’s Atomic images (Silverblue, Kinoite, etc.), and Universal Blue images (Bazzite, Bluefin, etc.).

AtomicXR#

The recommended way to set up Fedora Atomic for VR is with AtomicXR. See their readme for the most up-to date usage instructions.

Installation & Setup#

💡 Tip

You’ll need to install Homebrew to use AtomicXR. See this page for installation instructions. If you’re using a Universal Blue image (Bazzite, Bluefin, etc.), it’s already installed for you.

1. Add the AtomicXR Homebrew tap:

   brew tap matrixfurry/atomic-xr https://tangled.org/matrixfurry.com/homebrew-atomicxr

2. Install the AtomicXR CLI (axr):

   brew install atomicxr-cli

Envision#

Installation#

After installing the AtomicXR CLI, you can use axr envision install to install Envision.

Building profiles#

ℹ️ Note

It’s bad practice to install development packages on your base system, to improve system stability and performance. AtomicXR will instead set up a container with all your build dependencies installed. Launching Envision in build mode will start it inside of that container.

To build profiles, right-click Envision in your application menu and click “Launch in Build Mode”.

Overlays & Applications#

Install#

• WayVR: brew install --cask wayvr
• Monado Tracking Origin Calibrator: brew install --cask motoc
• OSC Avatar Manager: brew install --cask oscavmgr
• LÖVR Playspace: brew install lovr-playspace
• Index Camera Passthrough: brew install index-camera-passthrough

OscAvMgr#

OscAvMgr requires VrcAdvert to handle OscQuery.

A command is included to launch OscAvMgr and VrcAdvert together for you (use openxr for WiVRn):

axr oscavmgr start <babble|openxr|alvr>

Troubleshooting#

See this section in the README for the most up-to-date troubleshooting steps.

Envision plugin download failed#

Plugins should be installed from the AtomicXR Homebrew Tap instead of Envision. Envision doesn’t provide a way to download plugins via a command (yet).

Launching in build mode fails#

A workaround is launching with X11: distrobox enter envision -- bash -c 'export GDK_BACKEND=x11 && envision'

Support#

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