matrixfurry.com / atomic-xr
XR for Universal Blue and Fedora Atomic Desktops
vr fedora-atomic linux
4
fork

Configure Feed

Select the types of activity you want to include in your feed.

Nushell 95.4%
Shell 3.5%
Other 1.1%
111 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 Bluefin, but should work with:

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#

NOTE: If you plan to use the SteamVR Lighthouse driver with:

  • Flatpak Steam
  • WiVRn without a lighthouse-tracked headset (for example if you want to use lighthouse body trackers, but don't own a lighthouse headset)

..you can calibrate using AtomicXR instead of Envision: axr steamvr-lh calibrate

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

Building Envision profiles:

  • Right click Envision in your desktop's menu, and select "Launch in Build Mode"
  • You may also have to launch Envision in build mode to install WiVRn on your headset via ADB

Common Issues#

If you had AtomicXR installed before version 1.0.0, try running this command and rebooting:

  • nu -c "rm -rf ~/.local/share/atomic-xr $'($env.HOME)/.local/bin/{oscavmgr-launch,oscavmgr,motoc,wlx-overlay-s,wayvr-dashboard}' | str expand | str join ' '; try {toolbox rm -f atomic-xr}; try {rpm-ostree remove nu}"

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

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.
  • If AtomicXR installed Nushell for you, you can update it with brew upgrade