deckmaster
An application to control your Elgato Stream Deck on Linux
Installation
Packages
From source
Make sure you have a working Go environment (Go 1.11 or higher is required).
See the install instructions.
To install deckmaster, simply run:
git clone https://github.com/muesli/deckmaster.git
cd deckmaster
go build
System Setup
On Linux you need to set up some udev rules to be able to access the device as a
regular user. Edit /etc/udev/rules.d/99-streamdeck.rules
and add these lines:
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0060", MODE:="666", GROUP="plugdev", SYMLINK+="streamdeck"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0063", MODE:="666", GROUP="plugdev", SYMLINK+="streamdeck-mini"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006c", MODE:="666", GROUP="plugdev", SYMLINK+="streamdeck-xl"
Make sure your user is part of the plugdev
group and reload the rules with
sudo udevadm control --reload-rules
. Unplug and replug the device and you
should be good to go.
Starting deckmaster automatically
If you want deckmaster to be started automatically upon device plugin, you can use systemd path activation, adding streamdeck.path
and streamdeck.service
files to $HOME/.config/systemd/user
.
streamdeck.path
contents:
[Unit]
Description="Stream Deck Device Path"
[Path]
# the device name will be different if you use streamdeck-mini or streamdeck-xl
PathExists=/dev/streamdeck
Unit=streamdeck.service
[Install]
WantedBy=multi-user.target
streamdeck.service
contents:
[Unit]
Description=Deckmaster Service
[Service]
# adjust the path to deckmaster and .deck file to suit your needs
ExecStart=/usr/local/bin/deckmaster --deck path-to/some.deck
Restart=on-failure
[Install]
WantedBy=default.target
Then enable and start the streamdeck.path
unit:
systemctl --user enable streamdeck.path
systemctl --user start streamdeck.path
Configuration
You can find a few example configurations in the decks
directory. Edit them to your needs!
Usage
Start deckmaster
:
deckmaster -deck deck/main.deck
You can control the brightness, in percent:
deckmaster -brightness 50