DHIVA LABS · LEARN

Appearance

Install ​

Gearwise is released for Linux and Windows on x64 (x86-64) computers. Pick the section for your system. If the words PPA or .deb are new to you, read Installing apps first.

Ubuntu (PPA) ​

bash
sudo add-apt-repository ppa:dhiva-labs/apps
sudo apt install gearwise

The package also installs a udev rule, which is a small system file that lets your user account talk to the devices and to /dev/uinput (used to play macros). Unplug your devices and plug them in again after installing.

Debian or Ubuntu (.deb) ​

  1. Open the latest release and download gearwise_*_amd64.deb.

  2. Install it from the folder you downloaded it to:

    bash
    sudo apt install ./gearwise_*_amd64.deb

  3. Unplug your devices and plug them in again.

Any other Linux (tarball) ​

  1. Download gearwise-*-linux-x86_64.tar.gz from the latest release and extract it.

  2. In the extracted folder, install the udev rule once:

    bash
    sudo ./install-udev-rules.sh

  3. Start the app:

    bash
    ./gearwise

The Linux builds need glibc 2.35 or newer, which means Ubuntu 22.04 or a distribution of similar age or newer.

Windows ​

  1. Download gearwise-*-windows-x86_64.zip from the latest release and extract it.

  2. Close Logitech G HUB, Razer Synapse, Corsair iCUE and SteelSeries GG if they are running.

  3. Run gearwise.exe.

WARNING

Do not run Gearwise next to the vendor's software. Those programs can hold a device exclusively, so Gearwise cannot open it, or they can overwrite the settings you make.

Check your download ​

Every release lists a SHA256SUMS file. To check a download on Linux, put both files in one folder and run:

bash
sha256sum --check --ignore-missing SHA256SUMS

Check the version ​

bash
gearwise --version

Inside the app, the version is under Settings, in the About section.

Next steps ​