Dashy

A lightweight OpenXR/OpenVR overlay for Wayland desktops.

Dashy lets you access your desktop screens while in VR, and even launch apps directly in VR.

Setup

Installation (TODO: Rewrite this for dashy)

There are multiple ways to install Dashy:

1. AppImage: Download from Releases
2. AUR package: wayvr or wayvr-git

General Setup

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

First Start

When the screen share pop-up appears, check your notifications or the terminal and select the screens in the order it requests.

In case screens were selected in the wrong order:

• Go to Settings and press Clear PipeWire tokens and then Restart software
• Pay attention to your notifications, which tell you in which order to pick the screens.
• If notifications don't show, try starting WayVR from the terminal and look for instructions in there.

WiVRn users: Select WayVR from the Application drop-down. If there's no such entry, select Custom and browse to your WayVR executable or AppImage.

This will show a home environment with headset passthrough enabled by default or a customizable background!

The watch

Check your left wrist for the watch. The watch is the primary tool for controlling the app.

The top of the watch shows device batteries, and the bottom shows your overlay controls.

Enter edit mode (the leftmost button at the bottom) to edit your overlay sets.

While in edit mode, the watch can also be grabbed and passed between your hands.

After grabbing, the watch will automatically attach to the hand that's opposite from the one that held it.

In edit mode, try hovering over other overlays to see their advanced options!

Troubleshooting

When an error is detected, we often print tips for fixing it into the log file.

Logs will be at /tmp/wayvr.log for most distros.

Check here for tips.

Known Issues

Mouse is not where it should be

If the mouse is moving on a completely different screen, the screens were likely selected in the wrong order:

• Go to Settings and press Clear PipeWire tokens and then Restart software
• Pay attention to your notifications, which tell you in which order to pick the screens.
• If notifications don't show, try starting WayVR from the terminal and look for instructions in there.

COSMIC desktop:

• Due to limitations with COSMIC, the mouse can only move on a single display.

Modifiers get stuck

Hiding the keyboard will unpress all of its buttons. Alternatively, go to Settings and use the Restart software button.