Support us on Patreon to keep GamingOnLinux alive. This ensures all of our main content remains free for everyone. Just good, fresh content! Alternatively, you can donate through PayPal. You can also buy games using our partner links for GOG and Humble Store.
We do often include affiliate links to earn us some pennies. See more here.

Sadly, SteamVR on Linux continues to have quite a lot of quirks and over time it's gotten a little rough, here's a way to fix the SteamVR Overlay not working.

One of the most annoying bugs right now is how the SteamVR Overlay doesn't seem to work. Not just that, but even the settings menu from the main SteamVR menu doesn't seem to work either. This appears to be a problem on any Arch-like Linux distribution (EndeavourOS, Manjaro etc) and seems to originate with the vrwebhelper.

Thankfully, some clever people on the official Valve GitHub found a way to get it all working again and it's pretty simple.

First, find where SteamVR is installed, somewhere like this:

~/.local/share/Steam/steamapps/common/SteamVR/bin/vrwebhelper/linux64/

Open the file "vrwebhelper.sh" and replace this line:

export LD_LIBRARY_PATH="${STEAM_RUNTIME_HEAVY}${LD_LIBRARY_PATH+:$LD_LIBRARY_PATH}"

With this:

export LD_LIBRARY_PATH="${DIR}:${STEAM_RUNTIME_HEAVY}${LD_LIBRARY_PATH+:$LD_LIBRARY_PATH}"

Now you need to download an older version of freetype2, which another helpful user put up on a download link (web archive in case it vanishes) and then extract the files from the archive into the "vrwebhelper/linux64/" folder. After that, it all works just as expected again. Nice!

Hopefully Valve will get around to solving this soon, perhaps once they've got a few hands free after the Steam Deck ships, which they're clearly putting a lot of their effort into right now.

Article taken from GamingOnLinux.com.
25 Likes
About the author -
author picture
I am the owner of GamingOnLinux. After discovering Linux back in the days of Mandrake in 2003, I constantly came back to check on the progress of Linux until Ubuntu appeared on the scene and it helped me to really love it. You can reach me easily by emailing GamingOnLinux directly.
See more from me
The comments on this article are closed.
16 comments
Page: «2/2
  Go to:

TheRiddick Nov 18, 2021
The VR kit I was expecting to get next month (DecaGear1) has been delayed by another 12months so no VR for me.

It's rather unfortunate as it's release will likely be after many other options appear, they didn't have much competition in Q4 '21 or Q1 '22. They could find themselves releasing a outdated feature poor headset if not careful!
Termy Nov 18, 2021
Quoting: PalancaValve is doing since last year a poor job on Linux and virtual reality.

I have the very same impression sadly. I really hope that's just because they are caught up with the Deck and it will get better again when that is released and settled down.
Ehvis Nov 18, 2021
View PC info
  • Supporter Plus
Quoting: Termy
Quoting: PalancaValve is doing since last year a poor job on Linux and virtual reality.

I have the very same impression sadly. I really hope that's just because they are caught up with the Deck and it will get better again when that is released and settled down.

It appears that even Valve is not willing to put more than a minimum of effort in to support a niche of a niche. Never forget that they're a business. The current focus is the Steam Deck, which is not a realistic device for VR. I do think they still have bigger plans for the future though and if this includes something with more power, then SteamVR may become a priority.
posthum4n Nov 18, 2021
Yep, I gave up on Linux VR and installed Windows as dual-boot for VR.

It feels like they're not fixing VR because of the small user base, but there will never be a Linux VR user base if they don't fix even the obvious bugs. Chicken <> Egg.


Last edited by posthum4n on 18 November 2021 at 9:22 am UTC
pete910 Nov 18, 2021
View PC info
  • Supporter Plus
Never had the overlay issue, Does this only happen under certain circumstances ?

Run Manjaro since Antergos packed in.
micke1m Nov 21, 2021
Valve Index / Steam VR has not worked for me for more than a year. It just complains about direct display mode and clicking to enable it does nothing to fix it.
While you're here, please consider supporting GamingOnLinux on:

Reward Tiers: Patreon. Plain Donations: PayPal.

This ensures all of our main content remains totally free for everyone! Patreon supporters can also remove all adverts and sponsors! Supporting us helps bring good, fresh content. Without your continued support, we simply could not continue!

You can find even more ways to support us on this dedicated page any time. If you already are, thank you!
The comments on this article are closed.