Installing

From Sources (Git / PyPI)

Prerequisites

Linux

Installation require a compilation toolchain and python headers to compile hidapi (if the wheel (binary package) cannot be used).

  • On Debian / Ubuntu, this can be installed with the following command:

    sudo apt install build-essential python3-dev libusb-1.0-0-dev libudev-dev
    
  • On Solus, use the following commands:

    sudo eopkg install -c system.devel
    sudo eopkg install python3 python3-devel libusb-devel
    

We will also need Python’s venv module that is packaged separately on Debian / Ubuntu, so you will have to install it with the following command:

sudo apt install python3-venv

Windows

On Windows, you have to install Python first:

And Vusual C++ build tools are also required to compile hidapi if the weel (binary package) cannot be used:

Installing From PyPI

First create a virtualenv using the following command:

python3 -m venv ./rivalcfg.env

This will create a rivalcfg.env folder in the current directory. We will then be able to install Rivalcfg in it with the following command:

  • On Linux or macOS:

    ./rivalcfg.env/bin/pip install rivalcfg
    
  • On Windows:

    .\rivalcfg.env\Scripts\pip install rivalcfg
    

Installing From GitHub

Clone the repository:

git clone https://github.com/flozz/rivalcfg.git
cd rivalcfg

Then create a virtualenv using:

python3 -m venv ./rivalcfg.env

This will create a rivalcfg.env folder in the current directory. Finally, install Rivalcfg in it with the following command:

  • On Linux or macOS:

    ./rivalcfg.env/bin/pip install rivalcfg
    
  • On Windows:

    .\rivalcfg.env\Scripts\pip install rivalcfg
    

After the installation (Linux)

Once Rivalcfg installed from sources (Git or PyPI), you will have to run the following command on udev-based Linux distro (Debian / Ubuntu / Fedora / …):

sudo ./rivalcfg.env/bin/rivalcfg --update-udev

Running Rivalcfg from the CLI

On Linux and macOS:

./rivalcfg.env/bin/rivalcfg --help

On Windows:

.\rivalcfg.env\Scripts\rivalcfg --help

Running Rivalcfg from a script (Bash)

To run Rivlacfg from a shell script, you can import the virtualenv at the start of the script (before calling the rivalcfg command for the first time).

Example:

#!/bin/bash

# Import the virtualenv
source /path/to/rivalcfg.env/bin/activate

# Call Rivalcfg
rivalcfg --help

Archlinux AUR Package

Use package rivalcfg

Warning

This package is no longer maintained.