WayVR v26.2.1 (formerly WlxOverlay-S)

This is a bugfix release that fixes issues with newer Monado / WiVRn versions.

If you're getting weirdly stretched overlays, update your Monado/WiVRn to latest version.

If stuck on an old Monado/WiVRn and unable to upgrade, use WayVR v26.2 instead!

What's new:

• Stretchy overlays fix (@ImSapphire)
• No longer bind simple_controller (WiVRn hand-emulated controller) by default (@SpookySkeletons)
• The keyboard set buttons being 2 pixels off will no longer trigger you (@ImSapphire)
• Fixed missing translations (@olekolek1000)

WayVR v26.2.0 (formerly WlxOverlay-S)

This is a feature release that pairs with WiVRn release 26.2 as well as current Monado main.

While WayVR will work with older versions of Monado / WiVRn, some features like input blocking and overlay transparency will not function completely with older versions.

What's new since 26.1.2:

Highlights:

• Added Chinese (simplified) & Italian translations. (@BERADQ)
• Handsfree mode to control WayVR without controllers.
• Orange-click on taskbar toggles overlay (@OrionMoonclaw)
• Input blocking improvements. It's now possible to only block button input, while allowing the game to still track your devices. (@ImSapphire)
• Tooltip animations
• wayvrctl switch-set. Bind on your desktop for ultimate productivity.

Overlay settings (Accessible via edit mode):

• Per-overlay "Always visible" checkbox.
• Per-overlay input blocking (@OrionMoonclaw)
• Per-overlay "Angle fade" option (currently only works on some overlays, see known issues)
• Static positioning no longer makes an overlay always visible.

Dashboard, settings:

• Added "Reset Playspace" button to Settings/Troubleshooting
• Running games list
• Settings panel is now tabbed for easier navigation
• Switching watch 12h↔24h will also switch it on the keyboard bar without a restart (@ImSapphire)
• Toggling skybox & passthrough at runtime (@ImSapphire)

Customization:

• Buttons now support multiple actions: _press, _press2 etc. These are executed in order.
• Customizable audio effects (@cubee-cb)
• Fixed custom UI actions activating regardless of press length / button constraints
• More robust way of passing string args to ::OscSend (@cubee-cb)

Stereo mode:

• "Adjust mouse" checkbox (to be used with apps like Blender)
• Full-frame stereo support (full-SBS & friends, @amoshydra)
• Fixed stereo mode on apps launched inside WayVR

Misc fixes:

• Audio device list is now scrollable
• Fix alpha on all overlays when using Monado (requires WiVRn 26.2+ or main branch Monado)
• Fix keyboard modifier highlights (@ImSapphire)
• Fix keycaps missing shift-symbols on US layout
• Fix scale resetting when changing grab mode (@OrionMoonclaw)
• Fix 2D scroll on apps launched inside WayVR (@OrionMoonclaw)
• Fix locales not being picked up correctly (@BERADQ)
• Fixed "ScreenCopy GPU" capture on Nvidia cards
• Fixed watch grabbable even while not in edit mode (@ImSapphire)

Known issues:

• SteamVR 2.14.x forcibly unlinks WayVR's pipewire capture nodes. Pipewire screen capture will not work under SteamVR 2.14.x
• KDE Plasma 6.6 BETA 1 forcibly hides some windows from PipeWire capture "for your privacy". There's no way to show these windows as of now. This is fixed in BETA 2
• An upstream bug in the SVG library, can cause WayVR to crash when opening the "Apps" tab.

WayVR v26.1.2 (previously WlxOverlay-S)

This release brings a complete UI rework along with many major changes.

Important things first

• Settings are now on the dashboard.
• Config folder moved from ~/.wlxoverlay to ~/.wayvr, but probably start clean.
• Overlays now move together by default. Use both hands and grab different overlays if you want to move them separately. In order to move overlays individually, it's possible to change the per-overlay setting in edit mode.
• Edit mode gives you the power to move all overlays individually (including the watch! move it to your other hand and it will stick!), attach overlays to devices, apply mouse fixes, use SBS 3D mode.
• No need to have the old "WayVR Dashboard" anymore. Feel free to uninstall it.

But wait, there's more

• Custom UI panels with programatically alterable text, colors, images.
• 4 additional languages: German, Japanese, Polish, Spanish (uses your system locale)
• Reworked built-in Wayland server to use Vulkan instead of EGL (fixes NVIDIA-specific issues)
• WayVR Dashboard has been integrated into the main app, and it's been rewritten to be more performant.
• New screen capture method: ScreenCopy GPU. No screen select pop-ups. Works Hyprland, Niri, River, Sway and all wlroots compositors.

Packages

• AUR: wayvr & wayvr-git
• Fedora: TBD
• Gentoo: app-misc/wayvr (guru)
• Nix: TBD
• Cargo: cargo install --git https://github.com/wlx-team/wayvr.git --frozen
• Homebrew: TBD

New Contributors

• @amalon made their first contribution in #215
• @ImSapphire made their first contribution in #218
• @TayouVR made their first contribution in #219
• @KarlOfDuty made their first contribution in #231
• @SpookySkeletons made their first contribution in #247
• @matrixfurry made their first contribution in #244
• @sorche942 made their first contribution in #249
• @Krzeszny made their first contribution in #277
• @MagicBOTAlex made their first contribution in #281
• @Okabintaro made their first contribution in #303
• @mitsuami-megane made their first contribution in #318
• @dependabot[bot] made their first contribution in #325
• @amoshydra made their first contribution in #338
• @Helooprototo made their first contribution in #349

Full Changelog: v25.4.2...v26.1.2

WlxOverlay-S v25.4.2

What's new:

• Fix crash on SteamVR
• Added workarounds for COSMIC desktop
• Add binding for space_reset, now double-tap of space_drag by default (@AdalynBlack)
• Add basic input blocking (@OrionMoonclaw)

WlxOverlay-S v25.4.1

What's new:

• Major performance improvements

WlxOverlay-S v25.4.0

What's new:

• Fix OpenXR IPD calculation (@Beyley)
• New logging implementation (@olekolek1000)
• Improved scrolling behavior & horizontal scrolling support (@AdalynBlack)
• Configurable toast sound (@cubee-cb)
• Publish tarballs of cargo crates with each release (@xytovl)
• WayVR improvements:
  • fixed keyboard
  • added modifier key support
  • support software texture blitting for drivers where DMA-buf is problematic (Nvidia) (@olekolek1000)
  • fixed toplevel windows sticking around in the taskbar after closing (@olekolek1000)

WlxOverlay-S v25.3

What's new:

• Support for WayVR Dashboard 0.2.5

WlxOverlay-S v25.2

What's new:

• year.month.patch versioning
• WayVR integration @olekolek1000
• Systemd service for Monado @Scrumplex
• Configurable Purple laser modifier @Anon-11487
• support wivrn passthru mode
• sane watch timezone defaults
• timezones are now in conf.d, not watch.yaml (watch.yaml will still work) Wiki link
• bump max curvature to 180deg
• persist keyboard hide state across sessions
• OSC buttons @cubee-cb
• Fix keyboard/mouse issues on some setups @oneshinyboi

WlxOverlay-S v0.6

What's new:

• fixed crash on some desktops when using DMA-buf capture for extended periods
• mouse is no longer releases when the pointer momentarily leaves the screen
• dbus notifications for screen selection instructions
• added VirtualKey action for custom UI modular elements
• release modifier keys when the keyboard is hidden

WlxOverlay-S v0.5.0

What's new:

• fixed desktop capture on some desktops (thanks @raku-cat)
• openxr: binding for playspace reset (thanks @hypevhs)
• fix versioning (thanks @AdalynBlack)
• screen_render_down option, with 2 use-cases:
  • prevent screen aliasing
  • allow using dmabuf capture on desktops that zero the alpha channel
• openxr: laser pointer smoothing
• openxr: fix space rotate, toggle for space rotate axis lock
• pipewire capture now default on wlroots
• refined watch style