Skip to content

Installing on Arch

This has been tested on:

  • Arch with Plasma (July 2023)
  • Arch with Cinnamon (October 2023)
  • Arch with Gnome (Per every release, thanks to dhtseany)
  • Arch with Sway ans wayland

AUR

On Arch Linux, its recommended installing from AUR repositorues. there are two AUR packages available:

  1. streamdeck-ui: This package targets official and stable releases.
  2. streamdeck-ui-git: This package targets the git repository's master branch. It provides you with the latest updates but may be unstable at times.

The AUR packages install all the necessary dependencies and udev rules, so you do not need to continue further in this document.

Manual / source install

Install Dependencies

sudo pacman -S hidapi qt6-base

Set path

You need to add ~/.local/bin to your path. Be sure to add this to your .bashrc (or equivalent) file, so it automatically sets it for you in the future.

PATH=$PATH:$HOME/.local/bin

Configure access to Elgato devices (udev rules)

The following will create a file called /etc/udev/rules.d/60-streamdeck.rules with all the necessary udev rules that provides your user with access to USB devices created by Elgato.

sudo wget https://raw.githubusercontent.com/streamdeck-linux-gui/streamdeck-linux-gui/main/udev/60-streamdeck.rules -O /etc/udev/rules.d/60-streamdeck.rules

alternatively to grabbing the file directly from the repository you can use the following command:

sh -c "echo -e 'SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0fd9\", ATTRS{idProduct}==\"0060\", TAG+=\"uaccess\"\\n'\
'SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0fd9\", ATTRS{idProduct}==\"0063\", TAG+=\"uaccess\"\\n'\
'SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0fd9\", ATTRS{idProduct}==\"006c\", TAG+=\"uaccess\"\\n'\
'SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0fd9\", ATTRS{idProduct}==\"006d\", TAG+=\"uaccess\"\\n'\
'SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0fd9\", ATTRS{idProduct}==\"0080\", TAG+=\"uaccess\"\\n'\
'SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0fd9\", ATTRS{idProduct}==\"0084\", TAG+=\"uaccess\"\\n'\
'SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0fd9\", ATTRS{idProduct}==\"008f\", TAG+=\"uaccess\"\\n'\
'KERNEL==\"uinput\", SUBSYSTEM==\"misc\", OPTIONS+=\"static_node=uinput\", TAG+=\"uaccess\", GROUP=\"input\", MODE=\"0660\"' > /etc/udev/rules.d/60-streamdeck.rules"

For the rule to take immediate effect, run the following command:

sudo udevadm trigger

If the software is having problems later to detect the Stream Deck, you can try unplugging/plugging it back in.

Install Streamdeck

From Pypi with pipx

sudo pacman -S python-pipx
pipx install  streamdeck-linux-gui

From Source

Please make sure you have followed Install dependencies and Configure access to Elgato devices before continuing.

The steps to install from source can be found here

Launch the Streamdeck UI

Launch with

streamdeck

See troubleshooting for tips if you're stuck.