View source for Linux notes

<sub>(Todo: Update by people who have actually tested each method can can provide caveats. Please provide more than one option if possible with the 'Preferred' option at the top of the list)</sub>

In general, Resonite itself is functional on Linux. Due to the multiprocess architecture and sub-par Linux support for Unity 2019, the renderer is run through [https://en.wikipedia.org/wiki/Proton_(software) Proton], while FrooxEngine itself is run natively and invoked by the renderer. As such, you will still need to launch Resonite through Proton on Steam.

This page is not a comprehensive overview of general Linux VR support, and it may have outdated information due to the rapidly developing landscape. Up to date information on general Linux VR support can be found on the [https://lvra.gitlab.io/ Linux VR Adventures] wiki. In addition, the [[Main Page#Social links|official Resonite Discord]] has a [https://discord.com/channels/1040316820650991766/1183927772700213299 <code>#🐧resonite-on-linux</code>] channel to talk about and get real-time support on any issues when running Resonite on Linux.

The LVRA wiki also contains [https://lvra.gitlab.io/docs/resonite/ a specific page on Resonite] for any information not covered here, as well as troubleshooting for potential edge-case problems one may encounter.

== Clipboard support ==

Clipboard functionality will only work on [https://en.wikipedia.org/wiki/Wayland_(protocol) Wayland] displays. You can check if you are using Wayland by opening a terminal and typing <code>echo $WAYLAND_DISPLAY</code>. If a value is output, then you are using Wayland.

Additionally, [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5961 clipboard does not currently work for GNOME Wayland]. This will eventually be fixed.

If you are not using Wayland, then you are probably using X11. Clipboard functionality will not work out-of-the-box on X11 and [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5975#issuecomment-3673860395 it most likely never will]. However, there exists [https://git.unix.dog/yosh/ResoniteX11Clipboard a mod] to get clipboard functionality on X11.

== VR setup ==

SteamVR is known to have performance and stability issues under Linux, especially with Nvidia GPUs. It is highly recommended to use [https://lvra.gitlab.io/docs/fossvr/wivrn/ WiVRN] for standalone headsets or [https://lvra.gitlab.io/docs/fossvr/monado/ Monado] for PCVR headsets if you are able to.

If WiVRN or Monado don't work, using Steam Link is the next recommended method. This requires both the Steam client and SteamVR to be set on the "beta" branch.

[https://github.com/alvr-org/ALVR ALVR] with plain SteamVR is possible, but should only be used if the other methods do not work.

=== Desktop control ===

The desktop tab in the [[dash menu]] will not work on Linux. To view and control your desktop in VR, you can use [https://github.com/galister/wlx-overlay-s wlx-overlay-s].

== Individual distribution testing ==

This table catalogues testing done for Resonite on individual Linux distributions.

{| class="wikitable"
|+
! Distribution
! Status
! Notes
|-
| Fedora Linux 41, 42, 43
| Working
| VR through experimental Steam Link not working, use WiVrn.
|-
| Red Hat Enterprise Linux 10
| Working
|
|-
| Ubuntu
| Working
| Installing Steam through SNAP under Ubuntu based distros is known to break Lighthouse tracking, installing the .deb directly from Steam or your repository is recommended if this is a problem.
|-
| Bazzite
| Working
| Immutable distribution like Bazzite are, due to their nature, extra harder to install such tools on them. WiVRn from flatpak or Steamvr should work fine. But extra attention need to be given to the [https://lvra.gitlab.io/docs/distros/fedora_atomic/ dedicated LVRA page] for other type of installation.
Some tools may be trickier to install than on other distribution and VR support should be considered less mature.
|-
| Void Linux
| Working
| Untested on Musl LIBC. The dedicated wiki page is a bit outdated, and the flag <code>WIVRN_USE_SYSTEMD=OFF</code> must be provided for building WiVRn.
|-
| Arch Linux / CachyOS
| Working
| The AUR provide a few package for VR services if you do not want to use Envision. See the [https://wiki.archlinux.org/title/Virtual_reality VR page] on wiki for more details.
|-
|}