streamdeck is a library for interfacing with the Elgato/Corsair Stream Deck
This library is written in the programing language Go.
This project is a golang API for the Elgato/Corsair Stream Deck. This library unleashes the power of the StreamDeck. It allows you to completely customize the content of the device, without the need of the OEM's software.
streamdeck is published under the permissive MIT license.
There are a few go libraries which are needed at compile time. streamdeck does not have any runtime dependencies.
Compiling this library requires unfortunately a C compiler since the underlying HID library requires cgo for enumerating the HID devices.
The library should work on Linux, MacOS and Windows (>=7).
streamdeck works well on SoC boards like the Raspberry / Orange / Banana Pis.
On Linux you might have to create an udev rule, to access the streamdeck.
sudo vim /etc/udev/rules.d/99-streamdeck.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0060", MODE="0664", GROUP="plugdev"
After saving the udev rule, unplug and plug the streamdeck again into the USB port.
For the rule above, your user must be a member of the plugdev
group.
Make sure that your streamdeck is correctly recognized by executing:
$ go run examples/enumerate/enumerate.go
Found 1 Elgato Stream Deck(s):
SerialNumber: AL12H1A07123
The auto generated documentation can be found at godoc.org
Please checkout the dedicated repository streamdeck-examples for examples.
My personal library of streamdeck elements / buttons can be found in the streamdeck-buttons repository.
This project would not have been possible without the work of Alex Van Camp. In particular his notes of the StreamDeck's protocol were very helpful. Alex has provided a reference implementation in Javascript / Node.js.