Skip to content

Linux setup ​

These are the packages needed to build and run the desktop app on Debian/Ubuntu, Fedora or Arch. Audio processing happens on the mixer, so no audio setup is needed on the computer.

The project is developed on Fedora. The Debian/Ubuntu and Arch lists haven't been tested end to end, and package names change between releases.

System packages ​

Debian / Ubuntu ​

bash
sudo apt update
sudo apt install git curl build-essential pkg-config cmake clang \
  libfontconfig1-dev libwayland-dev libxkbcommon-dev libxkbcommon-x11-dev \
  libx11-dev libxcb1-dev libvulkan1 mesa-vulkan-drivers libasound2-dev \
  libssl-dev libudev-dev libdbus-1-dev policykit-1

On some releases the polkit package is called pkexec instead of policykit-1. Install just and zig from your distribution if it packages them, or from upstream.

Fedora ​

bash
sudo dnf install git curl gcc gcc-c++ pkgconf-pkg-config cmake clang \
  fontconfig-devel wayland-devel libxkbcommon-devel libxkbcommon-x11-devel \
  libX11-devel libxcb-devel vulkan-loader mesa-vulkan-drivers alsa-lib-devel \
  openssl-devel systemd-devel dbus-devel polkit just zig

Arch ​

bash
sudo pacman -S --needed git curl base-devel pkgconf cmake clang \
  fontconfig wayland libxkbcommon libxkbcommon-x11 libx11 libxcb \
  vulkan-icd-loader alsa-lib openssl systemd dbus polkit just zig

Also install the Vulkan driver for your GPU (vulkan-radeon, vulkan-intel, or NVIDIA's packages).

Notes ​

  • GPUI needs a graphical session and a working Vulkan driver.
  • The installer gets root through pkexec. On minimal desktops, make sure a polkit authentication agent is running.
  • Fedora's zig 0.16 with cargo-zigbuild 0.24 is known to work for the mixer build. Other version combinations probably work but haven't all been tested.

Continue with Building from source.

USB permission ​

The app needs read/write access to the mixer's hidraw device. The rule in the repository grants it to the user logged in at the desktop, for the Pro II and Duo in their normal USB modes:

bash
sudo cp config/udev/70-rc2fx.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger --action=add --subsystem-match=hidraw

The rule does not cover USB update mode. In that mode only the installer's root helper talks to the mixer.

Access comes from the desktop seat (logind), so an SSH-only session may not get it. If the app reports USB permission required: Permission denied, check that the rule is installed and that you are logged in at the machine. The app retries on its own, so nothing needs restarting. Don't run the app as root.