ALVR-IPv6/wiki/Flatpak.md

3.3 KiB

Installing ALVR and using SteamVR on Linux through Flatpak

Disclaimer

  1. This is not a fully-featured version of ALVR! It lacks Nvidia support, a desktop file, and has bugs related to Flatpak sandboxing

  2. Nvidia GPUs are currently not supported

  3. Native Linux SteamVR utility applications such as OpenVRAS are not supported nor tested, use at your own risk

  4. Firewall configuration does not work

  5. Any scripts that affect the host will run within the sandbox

  6. Sometimes, a new instance of Steam will launch when launching the dashboard. To fix this, close both ALVR and Steam then launch Steam. As soon as Steam is opens to the storefront, launch the ALVR dashboard.

  7. The ALVR Dashboard is not available in the Applications menu. To run the dashboard, run the following command to run alvr_dashboard in the Steam Flatpak environment:

flatpak run --command=alvr_dashboard com.valvesoftware.Steam

Dependencies

First, flatpak must be installed from your distro's repositories. Refer to this page to find the instructions for your distro.

Once Flatpak is installed, the flatpak dependencies must also be installed. They are:

  • Flatpak Builder
  • Rust
  • LLVM
  • Freedesktop SDK
  • Steam

These can be installed like so:

flatpak install flathub org.flatpak.Builder \
    org.freedesktop.Sdk//22.08 \
    org.freedesktop.Sdk.Extension.llvm16//22.08 \
    org.freedesktop.Sdk.Extension.rust-stable//22.08 \
    com.valvesoftware.Steam

AMD users may need to install the appropriate Mesa codec extensions as well:

flatpak install flathub org.freedesktop.Platform.GL.default//22.08-extra \
   org.freedesktop.Platform.GL32.default//22.08-extra

Build and Install

Once the dependencies are fulfilled, clone and enter the repository.

git clone https://github.com/alvr-org/ALVR.git
cd ALVR

Once inside the repository, simply run the following command to build and install the Flatpak.

flatpak run org.flatpak.Builder --user --install --force-clean .flatpak-build-dir alvr/xtask/flatpak/com.valvesoftware.Steam.Utility.alvr.json

Notes

Running the dashboard

To run the ALVR Dashboard, run the following command:

flatpak run --command=alvr_dashboard com.valvesoftware.Steam

A desktop file named com.valvesoftware.Steam.Utility.alvr.desktop is supplied within the alvr/xtask/flatpak directory. Move this to where other desktop files are located on your system in order to run the dashboard without the terminal.

Other Applications

The support for other applications that are not launched via Steam is non-existent due to the Flatpak sandbox.

Various SteamVR utilities such as WlxOverlay and OpenVR-AdvancedSettings cannot run within the Flatpak sandbox due to their usage of AppImage. However, unpacking the supplied AppImage or building the utilities from source and running their binaries from within the sandbox similiarly to alvr_dashboard could work, but there is no guarantee that they will work properly.

Some applications such as Godot support OpenXR. However, unless they are launched within the Steam Flatpak sandbox, they will not work with the Steam Flatpak. See here for more details.