Skip to main content

System

Configure the system preferences.
All settings on this page are device-specific. They are not synced to the cloud (Device-Specific Settings).

Max Frame Rate​

Sets the maximum frame rate.

Trigger Input Threshold​

Sets the amount of trigger depression required to execute actions.

Grip Input Threshold​

Sets the amount of grip pressure required to execute actions.

Stick Input Dead Zone​

Sets the dead zone for stick input. Default is 0.15.
This setting is shared between frame size adjustment and the one-handed panel cursor.

Launch at SteamVR Startup​

Enable or disable SteamVR startup auto-start.

info

This value is changed by referring to the settings on the SteamVR side. The settings will be changed after restarting SteamVR.

Block Input to Background Apps​

Blocks controller input from reaching background games and apps while operating VRHandsFrame. Default is ON.
When set to OFF, input is never blocked regardless of the sub-settings below.

Block During Frame Creation​

Blocks controller input to background apps while holding up a frame. Default is ON.

Block During Panel Operation​

Blocks controller input to background apps while operating a panel (grabbing or touching). Default is ON.

info

While processing (recording a GIF, scanning a 2D code, or processing a captured image), input is not blocked regardless of the settings.
In Translation Mode, to prevent accidental operations, processing time is treated as frame creation and follows the Block During Frame Creation setting.

Enable global input from overlays​

Input blocking requires the SteamVR setting "Enable global input from overlays (Experimental)" (SteamVR Settings > Developer).
The state of this SteamVR setting is shown below the sub-settings. While it is disabled, input is not blocked and the Enable global input from overlays button is shown. Press the button to enable the SteamVR setting. You do not need to restart SteamVR.
This item is hidden while Block Input to Background Apps is OFF.

info
  • This is a SteamVR-wide setting. It stays enabled after VRHandsFrame exits and also applies to other overlay apps that use the same mechanism. You can disable it at any time in SteamVR Settings (Developer).
  • VRHandsFrame never disables this setting. If input blocking is turned ON, VRHandsFrame enables it only once, at the first launch after installing or updating to version 2.3.0 or later. If you disable it in SteamVR afterward, VRHandsFrame does not enable it again.

Hide Desktop Window​

Stores the desktop window in the task tray when inactive or minimized.
To display the window again, click the VRHandsFrame icon in the task tray.

Resolution Source​

Select the resolution reference source from either SteamVR or HMD Direct Input.

Aspect Ratio Adjustment​

Adjusts the aspect ratio of the image that SteamVR obtains from the HMD.

Width Ratio (%)​

Adjusts the width magnification.

Height Ratio (%)​

Adjusts the height magnification.

tip

SteamVR sometimes cannot obtain images with the correct aspect ratio depending on the HMD you are using (PSVR2, etc.).
In that case, adjust the aspect ratio of the input image in this item.

Use a Vulkan layer (Proton)​

Available on Steam Frame when running through Proton. Default is ON.
When ON, VRHandsFrame adds its own Vulkan layer to SteamVR and captures the VR view through it. When OFF, or while the layer cannot be used, the VR view is captured from the Headset View.

Changes take effect after SteamVR restarts. The current state is shown below the item, and it is shown in orange until SteamVR is restarted.
If the setting cannot be applied, or if the layer was stopped after repeated startup failures, press Retry.

info
  • On Windows, this item cannot be changed.
  • When capturing from the Headset View, "Renderpass Optimizations" for VRHandsFrame must be turned off in Steam.