matrixfurry.com / atomic-xr
XR for Universal Blue and Fedora Atomic Desktops
vr fedora-atomic linux
Star 4
Fork 2
Watch
Nushell 97%
Shell 3%
237 2 37
cli
.gitignore
.gitmodules
LICENSE
migrate.nu
migrate.sh
README.md
README.md

AtomicXR #

Warning

AtomicXR is no longer maintained. Homebrew-XR and it's formulae are the successor.

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 #

Note

This migration script is untested.

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
  • Homebrew-XR's Envision formula 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 Homebrew-XR's Envision Formula #

The old process for getting Envision to build software inside a container was complex and very prone to breaking. Homebrew-XR's Envision 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!

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:

  1. Install Nushell
  2. Clone this repo (with ModCLI submodule): git clone --recurse-submodules https://tangled.org/matrixfurry.com/atomic-xr
  3. Run the installer: atomic-xr/cli/install.nu

Uninstall: install.nu -u