Command line

On Linux, two Python scripts do everything the web tool does. They need Python 3.9 or newer and nothing else.

git clone https://github.com/FilipNone/OpenShifter.git
cd OpenShifter

Access without root (once)

python3 tools/openshifter_flash.py udev-rule | sudo tee /etc/udev/rules.d/70-openshifter.rules
sudo udevadm control --reload-rules

Then unplug the shifter and plug it back in. Without the rule, run the commands below with sudo.

Install firmware

Download the openshifter-….bin file from the latest release and use its name in the command below. Installing erases your calibration and settings. Firmware that is not from Turtle Beach may void the shifter's warranty, and OpenShifter comes with no warranty.

python3 tools/openshifter_flash.py info                          # which firmware is running (changes nothing)
python3 tools/openshifter_flash.py flash openshifter-0.5.0.bin   # asks you to type "flash" first

The same flash command puts the stock firmware back: give it VelocityOneTuner_Shift_Firmware.bin instead. If a flash stops halfway, run the same command again.

Calibrate and change settings

python3 tools/openshifter_ctl.py calibrate                # guided: neutral, handbrake, gears 1 to 8
python3 tools/openshifter_ctl.py calibrate --sequential   # also the sequential thresholds
python3 tools/openshifter_ctl.py status                   # settings, mode, lever position
python3 tools/openshifter_ctl.py color 255 182 78         # or '#ff8000', or default
python3 tools/openshifter_ctl.py logo on                  # or off
python3 tools/openshifter_ctl.py highlow toggle           # or button
python3 tools/openshifter_ctl.py balance                  # white balance, guided
python3 tools/openshifter_ctl.py gamma on                 # or off
python3 tools/openshifter_ctl.py neutral on               # neutral button, or off

After calibrating, unplug the shifter and plug it back in. calibrate and status also work with the stock firmware.