XR for Universal Blue and Fedora Atomic Desktops
vr
fedora-atomic
linux
Improve spelling and formatting
+37
-15
+37
-15
README.md
+37
-15
README.md
···
2
2
<!-- Copyright (c) 2025 Shiloh Fen <shiloh@shilohfen.com> -->
3
3
4
4
# AtomicXR #
5
+
5
6
XR for Universal Blue and Fedora Atomic Desktops.
6
7
7
8
This repo contains the AtomicXR core libraries and CLI. Other AtomicXR repos can be found below:
9
+
8
10
- [AtomicXR Homebrew Tap](https://tangled.org/@matrixfurry.com/homebrew-atomicxr): XR packaging for Fedora Atomic.
9
11
10
-
AtomicXR is developed and tested on [Bluefin](https://projectbluefin.io/), but should work with:
12
+
AtomicXR is developed and tested on Fedora, but should work with:
13
+
14
+
- [Bluefin](https://projectbluefin.io/)
11
15
- [Bazzite](https://bazzite.gg/)
12
16
- [Fedora Silverblue](https://fedoraproject.org/atomic-desktops/silverblue/)
13
17
- Other Fedora Atomic-based distros
···
15
19
> See also: [LVRA Wiki page](https://lvra.gitlab.io/docs/distros/fedora_atomic/) for Fedora Atomic
16
20
17
21
## Install ##
18
-
Homebrew (reccomeneded): `brew tap matrixfurry.com/atomicxr https://tangled.sh/@matrixfurry.com/homebrew-atomicxr; brew install atomicxr-cli`
22
+
23
+
Homebrew (recommended):
24
+
`brew tap matrixfurry.com/atomicxr https://tangled.org/matrixfurry.com/homebrew-atomicxr; brew install atomicxr-cli`
19
25
20
26
From this repo: `./install.sh`
21
27
22
28
## Usage ##
29
+
23
30
> [!IMPORTANT]
24
31
> To build profiles in Envision, right click it in your desktop's menu and select "Launch in Build Mode"
25
32
26
33
CLI:
34
+
27
35
- Install Envision: `axr envision install`
28
36
- Update Envision: `axr envision upgrade`
29
37
- Set up Steam Flatpak XR: `axr flatpak steam enable-xr`
30
-
- Launch [OSC Avatar Manager](https://github.com/galister/oscavmgr): `axr oscavmgr start [babble|openxr|alvr]` (use `openxr` for WiVRn)
31
-
- Install common runtime dependecies for XR: `axr runtime install xr`
32
-
- List avaliable CLI functions: `axr -l`
38
+
- Launch [OSC Avatar Manager](https://github.com/galister/oscavmgr): `axr oscavmgr start [babble|openxr|alvr]` (use
39
+
`openxr` for WiVRn)
40
+
- Install common runtime dependencies for XR: `axr runtime install xr`
41
+
- List available CLI functions: `axr -l`
33
42
34
-
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`
43
+
If you plan to use the SteamVR Lighthouse driver with Flatpak Steam or WiVRn (without a lighthouse-tracked headset), you
44
+
can calibrate using AtomicXR instead of Envision: `axr steamvr-lh calibrate`
35
45
36
46
You may have to launch Envision in build mode to install WiVRn on your headset via ADB
37
47
38
48
## Troubleshooting ##
39
49
40
50
### Missing dependencies while building Envision profiles
41
-
Make sure you're launching Envision in build mode; right click Envision in your application menu and select "Launch in Build Mode".
42
51
43
-
If you still get missing dependency errors while in build mode, try resetting the Envision build container: `axr envision uninstall && axr envision install`
52
+
Make sure you're launching Envision in build mode; right click Envision in your application menu and select "Launch in
53
+
Build Mode".
44
54
45
-
If you get errors after resetting the container and launching in build mode, please [open an issue](https://tangled.sh/@matrixfurry.com/atomic-xr/issues/new):
55
+
If you still get missing dependency errors while in build mode, try resetting the Envision build container:
56
+
`axr envision uninstall && axr envision install`
57
+
58
+
If you get errors after resetting the container and launching in build mode,
59
+
please [open an issue](https://tangled.sh/@matrixfurry.com/atomic-xr/issues/new):
60
+
46
61
- Prefix the title with "[Envision/build]"
47
62
- Attach your Envision profile to the report
48
-
- Click the menu button next to the profile name in Envision
49
-
- Select "Export Profile"
63
+
- Click the menu button next to the profile name in Envision
64
+
- Select "Export Profile"
50
65
51
66
### Formulae found in multiple taps
67
+
52
68
If you had AtomicXR or the Homebrew tap installed before Aug 10, 2025, you might see an error message like:
69
+
53
70
```
54
71
Error: Formulae found in multiple taps:
55
72
* shiloh/atomicxr/atomicxr-cli
···
59
76
To resolve this, remove the old tap with `brew untap shiloh/atomicxr`
60
77
61
78
### `unknown flag: -o` for `reject` function
79
+
62
80
- Make sure your Nushell version (`nu -v`) is up to date, `0.106.0` is the minimum required version.
63
81
64
82
### ADB reports that there are no devices connected
···
67
85
68
86
### Failed to connect to system bus: Could not connect: No such file or directory
69
87
70
-
This is caused by the system dbus not being avaliable in distrobox. Try launching Envision normally (not in build mode).
88
+
This is caused by the system DBus not being available in Distrobox. Try launching Envision normally (not in build mode).
71
89
72
90
### Envision Plugin download failed
73
91
74
-
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).
92
+
Plugins should be installed from the AtomicXR Homebrew Tap instead of Envision. Envision doesn't provide a way to
93
+
download plugins via a command (yet).
75
94
76
-
See the [AtomicXR Homebrew Tap](https://tangled.sh/@matrixfurry.com/homebrew-atomicxr) for a list of plugins you can install.
95
+
See the [AtomicXR Homebrew Tap](https://tangled.sh/@matrixfurry.com/homebrew-atomicxr) for a list of plugins you can
96
+
install.
77
97
78
98
## Support ##
79
99
80
-
You can open an issue on [Tangled](https://tangled.sh/@matrixfurry.com/atomic-xr/issues), ask questions in [this post](https://discord.com/channels/1065291958328758352/1389409336580767775) on the LVRA Discord, or [contact me](https://woosh.link/matrixfurry.com) directly.
100
+
You can open an issue on [Tangled](https://tangled.sh/@matrixfurry.com/atomic-xr/issues), ask questions
101
+
in [this post](https://discord.com/channels/1065291958328758352/1389409336580767775) on the LVRA Discord,
102
+
or [contact me](https://woosh.link/matrixfurry.com) directly.