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:
streamdeck-ui
: This package targets official and stable releases.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.