70 lines
2.9 KiB
Markdown
70 lines
2.9 KiB
Markdown
---
|
|
title: Fedora Atomic (Bazzite)
|
|
---
|
|
|
|
# Fedora Atomic
|
|
|
|
This documentation applies to both Fedora's Atomic images (Silverblue, Kinoite, etc.), as well as Universal Blue images (Bazzite, Bluefin, etc.)
|
|
|
|
# AtomicXR
|
|
|
|
The recommended way to set up Fedora Atomic for VR is with [AtomicXR](https://tangled.sh/@matrixfurry.com/atomic-xr). See the [README](https://tangled.sh/@matrixfurry.com/atomic-xr/blob/main/README.md) for the most up-to date usage instructions.
|
|
|
|
## Installation & Setup
|
|
{{% hint info %}}
|
|
You'll need to install [Homebrew](https://brew.sh/) to use AtomicXR. See [this page](https://docs.brew.sh/Homebrew-on-Linux#install) for installation instructions.
|
|
If you're using a Universal Blue image (Bazzite, Bluefin, etc.), it's already installed for you.
|
|
{{% /hint %}}
|
|
|
|
1. Add the AtomicXR Homebrew tap:
|
|
```sh
|
|
brew tap matrixfurry.com/atomicxr https://tangled.sh/@matrixfurry.com/homebrew-atomicxr
|
|
```
|
|
2. Install the AtomicXR CLI (`axr`):
|
|
```sh
|
|
brew install atomicxr-cli
|
|
```
|
|
|
|
## [Envision](/docs/fossvr/envision/)
|
|
|
|
### Installation
|
|
|
|
After installing the AtomicXR CLI, you can use `axr envision install` to install Envision.
|
|
|
|
### Building profiles
|
|
{{% hint note %}}
|
|
It's bad practice to install development packages on your base system, to improve system stabilty and performance.
|
|
AtomicXR will instead set up a container with all your build depencencies installed.
|
|
Launching Envision in build mode will start it inside of that container.
|
|
{{% /hint %}}
|
|
|
|
To build profiles, right click Envision in your application menu and click "Launch in Build Mode".
|
|
|
|
## Overlays & Applications
|
|
|
|
### Install
|
|
- [WlxOverlay-S](/docs/fossvr/wlxoverlay-s/): `brew install wlx-overlay-s`
|
|
- [WayVR Dashboard](/docs/fossvr/wlxoverlay-s/#wayvr-dashboard): `brew install --cask wayvr-dashboard`
|
|
- [Monado Tracking Origin Calibrator](/docs/fossvr/motoc/): `brew install motoc`
|
|
- [OSC Avatar Manager](https://github.com/galister/oscavmgr): `brew install oscavmgr vrc-advert`
|
|
|
|
### OscAvMgr
|
|
OscAvMgr [requires VrcAdvert to handle OscQuery](https://github.com/galister/oscavmgr?tab=readme-ov-file#setting-up-to-use-with-vrchat).
|
|
|
|
A command is included to launch OscAvMgr and VrcAdvert together for you (use `openxr` for WiVRn):
|
|
```sh
|
|
axr oscavmgr start <babble|openxr|alvr>
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
See [this section](https://tangled.sh/@matrixfurry.com/atomic-xr#troubleshooting) in the README for the most up-to-date troubleshooting steps.
|
|
|
|
### Envision Plugin download failed
|
|
|
|
Plugins should be installed from the [AtomicXR Homebrew Tap](https://tangled.sh/@matrixfurry.com/homebrew-atomicxr) instead of Envision. Envision doesn't provide a way to download plugins via a command (yet).
|
|
|
|
## Support
|
|
|
|
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 reach out to [the maintainer](https://woosh.link/matrixfurry.com) directly.
|