AtomicXR#

XR for Universal Blue and Fedora Atomic Desktops.

This repo contains the AtomicXR core libraries and CLI. Other AtomicXR repos can be found below:

• AtomicXR Homebrew Tap: XR packaging for Fedora Atomic.

AtomicXR is developed and tested on Bluefin, but should work with:

• Bazzite
• Fedora Silverblue
• Other Fedora Atomic-based distros

See also: LVRA Wiki page for Fedora Atomic

Install#

Homebrew (reccomeneded): brew tap matrixfurry.com/atomicxr https://tangled.sh/@matrixfurry.com/homebrew-atomicxr; brew install atomicxr-cli

From this repo: ./install.sh

Usage#

CLI:

• Install Envision: axr envision install
• Update Envision: axr envision upgrade
• Set up Steam Flatpak XR: axr flatpak steam enable-xr
• Launch OSC Avatar Manager: axr oscavmgr start [babble|openxr|alvr] (use openxr for WiVRn)
• Install common runtime dependecies for XR: axr runtime install xr
• List avaliable CLI functions: axr -l

If you plan to use the SteamVR Lighthouse driver with Flatpak Steam or WiVRn (without a lighthouse-tracked headset), you can calibrate using AtomicXR instead of Envision: axr steamvr-lh calibrate

You may have to launch Envision in build mode to install WiVRn on your headset via ADB

Troubleshooting#

Missing dependencies while building Envision profiles#

Make sure you're launching Envision in build mode; right click Envision in your application menu and select "Launch in Build Mode".

If you still get missing dependency errors while in build mode, try resetting the Envision build container: axr envision uninstall && axr envision install

If you get errors after resetting the container and launching in build mode, please open an issue:

• Prefix the title with "[Envision/build]"
• Attach your Envision profile to the report
  • Click the menu button next to the profile name in Envision
  • Select "Export Profile"

Formulae found in multiple taps#

If you had AtomicXR or the Homebrew tap 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

unknown flag: -o for reject function#

• Make sure your Nushell version (nu -v) is up to date, 0.106.0 is the minimum required version.

ADB reports that there are no devices connected#

Add yourself to the plugdev group with sudo usermod -a -G plugdev $USER, then reboot

Failed to connect to system bus: Could not connect: No such file or directory#

This is caused by the system dbus not being avaliable in distrobox. Try launching Envision normally (not in build mode).

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).

See the AtomicXR Homebrew Tap for a list of plugins you can install.

Support#

You can open an issue on Tangled, ask questions in this post on the LVRA Discord, or contact me directly.