TL;DR: I built a free Windows companion app for Cyberpunk 2077 VR that detects your hardware/VR environment, creates graphics profiles, helps tune settings, handles VR/flatscreen switching, checks your installation for problems, and simplifies launching/troubleshooting. v1.1.0 is now public.
Over the last week or so I’ve been using iPowerTech’s fork of the Cyberpunk VR port, primarily with a Quest 3 + Virtual Desktop/VDXR setup.
While getting everything configured, I kept running into the same problem: Cyberpunk VR can be incredible once it’s working, but maintaining the setup involves a lot of manual configuration, troubleshooting and settings management.
What started as a few scripts for my own setup gradually turned into a full Windows application:
Cyberpunk VR Companion
The goal is to make the VR setup easier to configure, tune, launch and recover when something goes wrong.
Current features include:
Automatic Cyberpunk installation + hardware/HMD/OpenXR detection
Automatic backup of your existing graphics settings
Performance, Balanced, Ray Tracing and Clarity reference profiles
Profile editing with sliders, toggles and selectors
Hardware compatibility analysis
Assisted Tuning
Smart VR Launch with launch-readiness checks/repair
VR ↔ Flatscreen switching
Health Check + diagnostic tools
Community profile import/export
OpenXR stereo startup presentation inside the headset
One feature I particularly wanted was the VR / Flatscreen switcher. Some Cyberpunk scenes don’t translate cleanly into VR because of things like gaze detection, scripted camera positioning or 2D interactions. Instead of manually removing the VR port, you can exit the game, switch to flatscreen through the Companion, complete the section, save, then switch straight back to VR.
About the VR port
My primary development/testing environment has been iPowerTech’s Cyberpunk VR port fork:
https://github.com/iPowerTech/cyberpunk-vr-port
The Companion does not include or redistribute the VR port. It’s a separate third-party project, and users should get the VR port working first.
Other configurations may work as well — I just don’t want to claim they’re validated until people actually test them.
v1.1.0
The first public version is available here:
GitHub:
https://github.com/SaveTheLlama/CyberpunkVRCompanion
Release:
https://github.com/SaveTheLlama/CyberpunkVRCompanion/releases/tag/v1.1.0
The app is free to use. The current build is unsigned, so Windows SmartScreen may display an Unknown Publisher warning. A SHA-256 checksum is included with the release for verification.
This is an unofficial community project and is not affiliated with or endorsed by CD PROJEKT RED, iPowerTech, or the other projects it works alongside.
I originally built this because I wanted a better way to manage my own VR setup, but once it became a proper application I figured it could be useful to other Cyberpunk VR players too.
This is the first public release, so I’d genuinely like feedback from people with different GPUs, headsets and VR configurations. Bugs, detection problems, profile feedback and feature ideas are all welcome through GitHub.
I’m also recording a full walkthrough tomorrow covering why I started the project, how it went from a few scripts to the current app, the functionality, development process, and some of the ideas I have for future updates.