Skip to content

Installation

James Ridgway edited this page Dec 28, 2020 · 14 revisions

Pre-requisite: LibUSB HIDAPI Backend

A HID backend is required to interact with the StreamDeck, otherwise you will encounter errors such as:

StreamDeck.DeviceManager.ProbeError: ('Probe failed to find any functional HID backend.', {'libusb': TransportError("No suitable LibUSB HIDAPI library found on this system. Is the 'libhidapi-libusb.so' library installed?")})                                         

Ubuntu

Install the following:

sudo install -y libudev-dev libusb-1.0-0-dev libhidapi-libusb0

# Add your user to plugdev group
sudo usermod -a -G plugdev `whoami`

# udev rule to allow all users non-root access to Elgato StreamDeck devices:
sudo tee /etc/udev/rules.d/10-streamdeck.rules << EOF
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0060", MODE:="660", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0063", MODE:="660", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006c", MODE:="660", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006d", MODE:="660", GROUP="plugdev"
EOF

# Reload udev rules to ensure the new permissions take effect
sudo udevadm control --reload-rules

Make sure to disconnect and reconnect your Stream Deck device after applying the udev rules

Installing DevDeck

pip install devdeck
Clone this wiki locally