Skip to content

A service to manage your Stream Deck easily on Linux

Notifications You must be signed in to change notification settings

Gabisonfire/deckster

Repository files navigation

Deckster

A service to manage your Stream Deck easily on Linux


Documentation

Online Documentation

Quickstart

pip install deckster-sd

The install process will create a default config.json to your ~/.config/deckster folder.

Install dependencies and add permissions:

# Install system packages needed for the default LibUSB HIDAPI backend
sudo apt install -y libudev-dev libusb-1.0-0-dev libhidapi-libusb0

# Install system packages needed for the Python Pillow package installation
sudo apt install -y libjpeg-dev zlib1g-dev libopenjp2-7 libtiff5

# Add udev rule to allow all users non-root access to Elgato StreamDeck devices:
sudo tee /etc/udev/rules.d/10-streamdeck.rules << EOF
    SUBSYSTEMS=="usb", ATTRS{idVendor}=="0fd9", GROUP="users", TAG+="uaccess"
    EOF
# Reload udev rules to ensure the new permissions take effect
sudo udevadm control --reload-rules

Service

You can have deckster run as a service by using the service file template in the repository.

mkdir -p $HOME/.local/share/systemd/user
cp deckster.service $HOME/.local/share/systemd/user
systemctl --user daemon-reload
systemctl --user enable 
systemctl --user start deckster