matrixfurry.com / atomic-xr
XR for Universal Blue and Fedora Atomic Desktops
fork atom
Nushell 94.2%
Shell 2.4%
Dockerfile 2.0%
Other 1.3%
211 2 37

Clone this repository

https://tangled.org/matrixfurry.com/atomic-xr https://tangled.org/did:plc:zmjoeu3stwcn44647rhxa44o/atomic-xr
git@tangled.org:matrixfurry.com/atomic-xr git@tangled.org:did:plc:zmjoeu3stwcn44647rhxa44o/atomic-xr

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

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 is developed and tested on Fedora, but should work with:

See also: LVRA Wiki page for Fedora Atomic

Install#

Homebrew (recommended): brew tap matrixfurry.com/atomicxr https://tangled.org/matrixfurry.com/homebrew-atomicxr; brew install atomicxr-cli

From this repo: ./install.sh

Usage#

IMPORTANT

To build profiles in Envision, right click it in your desktop's menu and select "Launch in Build Mode"

For an easy-to-follow guide, please see the LVRA Wiki page for Fedora Atomic.

Common CLI functions:

  • List available CLI functions: axr -l
  • 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)

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