Bring Your Linux Desktop Into VR Without Dragging Your Frame Rate Down

You've got a VR headset, a Linux machine, and a growing frustration: every time you want to peek at a chat window or check a tutorial while inside a game, you have to lift the headset. Desktop-in-VR overlays exist, but on Linux they've historically felt like an afterthought—heavy, clunky, and prone to tanking your performance in the very games you're trying to play.

That's where WayVR comes in. Formerly known as WlxOverlay-S, it's a lightweight OpenXR and OpenVR overlay that puts your Wayland or X11 desktop inside your VR session. The pitch is simple: give you access to your screens and even launch apps in VR, but do it with as little performance impact as possible so it can run alongside your games without becoming a problem itself.

What It Does

WayVR is essentially a bridge between your desktop compositor and your VR runtime. It works with the two main open-source Linux VR stacks—Monado and WiVRn—as well as SteamVR, and it lets you view your actual desktop screens as floating panels inside your headset. You can also launch applications directly into VR, and it can serve as a full home environment when you're not in a game.

Under the hood, it's built on OpenXR and OpenVR, which means it plugs into the same ecosystem as your VR games rather than reinventing the wheel. The project's stated design philosophy is to keep the UI appearance and rendering techniques "as simple and efficient as possible" while still offering a high degree of customizability. That's a deliberate trade-off: no fancy shaders, no unnecessary visual flourishes—just functional desktop access that doesn't compete with your GPU when you need it for something else.

The project is backed by the Linux VR Adventures community, and you can find support on their Discord or Matrix spaces if you run into issues.

Why It's Cool

What makes WayVR worth paying attention to isn't just that it exists—it's the design priorities baked into it.

• Performance is the headline feature. Most VR overlay tools treat performance as an afterthought. WayVR makes it the core requirement. The README explicitly states the goal is to run alongside VR games with "as little performance impact as possible," and the simple rendering approach reflects that. If you're playing something demanding on Linux VR—which already requires more tinkering than Windows—you don't want an overlay eating 10% of your frame time.

• The Flatpak Steam situation is handled. If you run Steam as a Flatpak (which many Linux gamers do for sandboxing and easy updates), getting VR overlays to work can be a nightmare of permission issues. WayVR's README includes specific steps to get it running with SteamVR via Flatpak, including a flatpak override command for PipeWire access. That's the kind of real-world documentation that saves you an afternoon of forum digging.

• It plays nice with the broader Linux VR ecosystem. Rather than trying to be a walled garden, WayVR integrates with Monado, WiVRn, and SteamVR. WiVRn users can select it directly from an application dropdown, and Envision users can toggle it as a plugin. It's built to fit into the existing open-source VR stack, not replace it.

• There's a fix for the screen-selection dance. The first time you start WayVR, it asks you to select which screens to share—but there's a known gotcha where you might pick them in the wrong order. The README doesn't just acknowledge this; it gives you a concrete fix (clear PipeWire tokens, restart, and watch your notifications for the correct order). That attention to UX friction is rare in open-source VR tools.

How to Try It

Getting started is straightforward, and there are several installation paths depending on your distro and preferences.

Installation options:

1. AppImage: Grab the latest from the Releases page
2. AUR: wayvr or wayvr-git for Arch users
3. Nix: Available in nixpkgs as wayvr, or via the nixpkgs-xr overlay
4. Homebrew-XR: For Bazzite and similar immutable distros
5. Build from source: See the docs

General setup is just two steps:

1. Start Monado, WiVRn, or SteamVR.
2. Run the overlay.

If you're using Monado or WiVRn, you're done—no extra configuration needed for Flatpak Steam compatibility. SteamVR via Flatpak users will need to follow the extra steps in the README, which involve extracting the AppImage and running it through the Flatpak sandbox with the right permissions.

One thing to note: WayVR no longer registers itself for auto-start with SteamVR due to bugs in SteamVR itself, so you'll need to launch it manually each time. It's an annoying workaround, but it's SteamVR's fault, not WayVR's.

Final Thoughts

WayVR is a solid answer to a very specific problem: Linux VR users who want desktop access without sacrificing performance. It's not flashy, and it doesn't pretend to be—the whole point is efficiency and low overhead. If you're already invested in Monado or WiVRn and you've been tolerating the hassle of pulling your headset off to check things, this is worth a shot.

The project is clearly still evolving (the name change from WlxOverlay-S alone suggests active development), and the community around it seems genuinely helpful. It won't magically fix all the rough edges of Linux VR, but it does make one part of the experience noticeably better. And honestly, on Linux, that's about the best you can ask for.

Follow @githubprojects for more developer tools and open source projects.