REV Hub Interface — Community Edition

This is the Community Edition of REV Hub Interface. REV Hub Interface allows you to manually control an Expansion Hub from your computer with zero code. Originally created by REV, we have now ported it to Linux and macOS. We have also added a more modern UI, more control features, and overhauled the backend to make everything more responsive.

Though the original version of the software was created by REV Robotics, this version is not maintained by or affiliated with REV Robotics. Please do not contact REV Robotics official support about any issues you experience with this software; instead, you may create a GitHub Issue or ask in our Discord server.

This software is licensed under the BSD-3-Clause license, as is the official REV version that it is based on. The full text is available in the LICENSE.txt file.

Installing the software

Start by downloading the latest version of the software from the Releases page.
An .exe is provided for Windows, a .DMG for macOS, and AUR Pkgbuild, Flatpak, and binary for Linux You can download from Flathub here. Alternately, you can download it from PyPi:

1. Install Python 3
2. Run pip install REVHubInterface to install
3. Finally, run python3 -m REVHubInterface to run the app (it should also be runnable as revhubinterface)

Access to serial on Linux

To avoid needing to run REV Hub Interface with root privileges on Linux, add your user to the dialout group:

1. this can be done with sudo usermod $USER -a -G dialout (on Arch Linux, you need to use uucp instead of dialout)
2. Reboot

Connecting and Controlling an Expansion Hub

1. Connect your Expansion Hub to the computer with a USB A to USB Mini-B cable.
2. Run the REV Hub Interface Software.
3. Press Connect. The software will scan and connect to the Expansion Hub. The various peripheral tabs will be populated with controls once connected.

Running the development version

Early binaries are available from the Actions tab, or from the pre-releases section of https://pypi.org/project/REVHubInterface/#history.

To compile yourself, first install a few additional dependencies:

• Python 3
• Tkinter
  • Windows: This is included in the Python 3 installer. Make sure the checkbox to install it is selected.
  • Linux: On Ubuntu and derivatives, this is installed with sudo apt install python3-tk. On Arc and derivatives, it can be installed with sudo pacman -Su tk. The package name should be similar on other distributions.
  • macOS: If using Homebrew, it can be installed via brew install python-tk.