Merge branch 'main' into 'main'

Add documentation for Fedora Atomic

See merge request lvra/lvra.gitlab.io!129
This commit was merged in pull request #134.
This commit is contained in:
hypevhs
2025-08-12 14:04:50 -05:00
2 changed files with 68 additions and 0 deletions

View File

@@ -0,0 +1,67 @@
---
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".
### Plugins
AtomicXR can register [Plugins](/docs/fossvr/envision/#plugin-system) for all supported overlays & tools, so you don't need to manually add each one:
```sh
axr envision plugins register
```
## Overlays & Applications
### Install
- [WlxOverlay-S](/docs/fossvr/wlxoverlay-s/): `brew install wlx-overlay-s`
- [WayVR Dashboard](https://github.com/olekolek1000/wayvr-dashboard): `brew install 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>
```
## 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.

View File

@@ -71,6 +71,7 @@ flatpak override --user --filesystem=xdg-config/openxr:ro com.valvesoftware.Stea
flatpak override --user --filesystem=xdg-config/openvr:ro com.valvesoftware.Steam
flatpak override --user --filesystem=xdg-run/wivrn com.valvesoftware.Steam
flatpak override --user --filesystem=/var/lib/flatpak/app/io.github.wivrn.wivrn:ro com.valvesoftware.Steam
flatpak override --user --filesystem=~/.var/app/io.github.wivrn.wivrn:ro com.valvesoftware.Steam
```
As an added bonus to the above, this command will save you the effort of having to set launch options for every single VR game in your Steam library: