Table of contents
Why the command line tool?
The OpenXR Toolkit command line too lets you create various shortcuts to control the OpenXR Toolkit features outside of the OpenXR Toolkit on-screen menu. For example, you may use Autohotkey to create keyboard shortcuts to toggle features on/off while in-game.
Syntax
Usage: C:\Program Files\OpenXR-Toolkit\companion.exe
[app <name>]
[-sunglasses <off|light|dark|trunite>]
[-post-process <off|on|ca_correction>]
[-contrast <[0,100]>]
[-brightness <[0,100]>]
[-exposure <[0,100]>]
[-saturation <[0,100]>]
[-vibrance <[0,100]>]
[-highlights <[0,100]>]
[-shadows <[0,100]>]
[-gain-r <[0,100]>]
[-gain-g <[0,100]>]
[-gain-b <[0,100]>]
[-world-scale <[0,1000]>]
[-zoom <[1,150]>]
[-frame-throttling <[15,120]>]
[-reprojection-rate <invalid|unlocked|1/2|1/3>]
[-over-prediction-reduction <-100,0>]
[-foveated-rendering toggle]
[-overlay toggle]
[-record-stats toggle]
[-turbo toggle]
When no app is specified, the currently running app is used.
Use syntax <+N> to add value N to integral and decimal values (N can be negative)
Use syntax <+N> to cycle by step N through enumeration values (with automatic wraparound)
Examples:
companion.exe -brightness 50.5 -contrast 45.8
Set brightness and contrast values for the currently running app
companion.exe -sunglasses +1
Cycle through sunglasses mode for the currently running app
companion.exe -world-scale +-10
Decrease world scale by 10% for the currently running app
companion.exe -overlay toggle
Toggle the overlay on/off for the currently running app
companion.exe app FS2020 dump
Dump settings for app 'FS2020' (Flight Simulator 2020)
The dump
option can be used to generate a command-line based on the current option values (eg: as you set from the menu in-game), so that you can copy/paste the command directly into a script:
> companion.exe dump
C:\Program Files\OpenXR-Toolkit\companion.exe app HelloXR -sunglasses light -post-process 1 -contrast 50 -brightness 0.1 -exposure 50 -saturation 50 -vibrance 0 -highlights 100 -shadows 0 -gain-r 50 -gain-g 50 -gain-b 50 -world-scale 101 -reprojection-rate 1/4