AtomicXR#
AtomicXR is no longer maintained. The following tools replace it, and achieve the same goals much more practical way:
- VR Homebrew Tap -> Homebrew-XR
- Envision on Fedora Atomic -> Envision-OCI
Migration Guide#
As of March 27, 2026, the AtomicXR CLI and Homebrew Tap have received their last updates, and have been replaced with better solutions. The changes are outlined below, with a script to help you migrate more easily.
Auto-migration script#
This script will automatically remove AtomicXR and install the new software:
bash -c "$(curl -fsSL https://tangled.org/matrixfurry.com/atomic-xr/raw/main/migrate.sh)"
Changes#
I recommend reading this section, but here's the TL;DR:
- Run the above migration script
- Envision-OCI is much easier to use. Just install it and start Envision as normal, everything else will be handled automatically. No more building from source or "Launch in Build Mode" required!
- AtomicXR CLI's manual system configuration commands are no longer necessary
1. The AtomicXR Homebrew Tap has been replaced by Homebrew-XR#
AtomicXR Homebrew Tap contained software that was specifically intended to only work on Fedora Atomic Desktops and Universal Blue distros (e.g. Bazzite). The builds there were often out of date, missing features that people needed, or just didn't work at all.
Homebrew-XR contains even more VR software, stays up to date, and works on almost any distro where Homebrew is installed, including Bazzite and Fedora.
2. Envision in Distrobox (axr envision) has been replaced with Envision-OCI#
The old process for getting Envision to build software inside a container was complex and very prone to breaking. Envision-OCI is much easier to use. All you need to do is install it and start Envision as normal, everything else will be handled automatically. No more building from source or "Launch in Build Mode" required!
Pre-built Monado packages will also be available soon in the Homebrew-XR repository. Most people won't need to worry about building it themselves. You'll be able to install Monado in seconds, and use Envision as an easy launcher and configuration tool.
3. AtomicXR CLI's manual system configuration commands are no longer necessary#
Using the AtomicXR CLI to manually configure your system was confusing and not at all obvious. Most people using AtomicXR
never touched anything but axr envision install, and there was no real way to know which commands you needed to run to
properly configure your system. If anything, these features caused more confusion than solved issues.
The necessary configuration will now be automatically applied when installing applications via Homebrew-XR
Legacy AtomicXR CLI usage (not recommended)#
Using the AtomicXR CLI is no longer recommended. However, if you still need it for whatever reason, the last version is still available.
Install:
- Install Nushell
- Clone this repo (with ModCLI submodule):
git clone --recurse-submodules https://tangled.org/matrixfurry.com/atomic-xr - Run the installer:
atomic-xr/cli/install.nu
Uninstall: install.nu -u