Bigscreen Freeyond

Bigscreen Freeyond is a free and open source utility for changing the settings of Bigscreen Beyond headsets.

It has only been tested with a Beyond 2E but should work for other models too.

Installation

To install the cli run within the repository:

cargo install --path bigscreen-freeyond-cli

Warning

Use of this utility is at your own risk of potential damage to the HMD.

When saving settings to the headset all settings are saved, including two serial numbers. To prevent any issues caused by losing your serial numbers, such as the official utility ceasing to be able to detect which model your HMD is, we suggest noting them down.

You can get the serial numbers by running

bigscreen-freeyond-cli --get-serials

alternatively one serial number is printed behind the facial interface, while the other is exposed by the Bigscreen Beyond USB device.

Usage

Change display brightness:

bigscreen-freeyond-cli -b100% # Set 100%
bigscreen-freeyond-cli -b60% # Set to 60%
bigscreen-freeyond-cli -b+10% # Increase by 10% of current value
bigscreen-freeyond-cli -b-5% # Decrease by 5% of current value

Change fan speed brightness:

bigscreen-freeyond-cli -f100% # Set 100%
bigscreen-freeyond-cli -f60% # Set to 60%
bigscreen-freeyond-cli -f+10% # Increase by 10%
bigscreen-freeyond-cli -f-5% # Decrease by 5%

Change the color of the LED to the given hex code:

bigscreen-freeyond-cli -lFF0000 # Red
bigscreen-freeyond-cli -l00FF00 # Green
bigscreen-freeyond-cli -l0000FF # Blue
bigscreen-freeyond-cli -lFFFFFF # White
bigscreen-freeyond-cli -l000000 # Black (Off)

Enable or disable high refresh rate, lower resolution mode:

bigscreen-freeyond-cli -r true # Enable
bigscreen-freeyond-cli -r false # Disable

All options can be combined into a single command:

bigscreen-freeyond-cli -b100% -f75% # Set brightness to 100% and fan speed to 75%
bigscreen-freeyond-cli -b50% -f60% -l000000 -r false # Set brightness to 50%, fan speed to 60%, turn off LED and disable high refresh mode

To persist settings to the headset, use the -s flag. Doing so will persist all settings. We cannot read the current settings from the headset, so if a value is not provided it will be set to the value last used using this utility, or to our defaults.

bigscreen-freeyond-cli -b100% -f60% -s # Set brightness to 100% and fan speed to 60%, and persist to the headset. This will also set your refresh rate and LED color to the last known value.

Changing IPD

Changing the IPD is not covered by this utility as it is a fairly uncommon task and already possible on Linux through SteamVR's lighthouse_console. To do so first download the lighthouse config of your device:

~/.steam/root/steamapps/common/SteamVR/tools/lighthouse/bin/linux64/lighthouse_console downloadconfig

The config will be downloaded to your current directory and named [lighthouse device serial number].json. Consider backing up this file as modifying anything other than IPD can easily cause issues. Then open this file in any text editor and under "ipd" set "default_mm" to your desired IPD value. Lastly upload the modified config to your headset:

~/.steam/root/steamapps/common/SteamVR/tools/lighthouse/bin/linux64/lighthouse_console uploadconfig

Licensing

This project is free and open source software dual-licensed under MIT + Apache 2.0 at your option.

Your contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be licensed as described above.