# README
streamdeck
streamdeck is a library for interfacing with the Elgato/Corsair Stream Deck
This library is written in the programing language Go.
Note
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.
License
streamdeck is published under the permissive MIT license.
Dependencies
There are a few go libraries which are needed at compile time. streamdeck does not have any runtime dependencies.
CGO
This version requires no CGO, but will only work on Linux (think raspberry pi, etc).
Supported Operating Systems
The library should work on Linux only.
streamdeck works well on SoC boards like the Raspberry / Orange / Banana Pis.
Linux Device rules
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.
Documentation
The auto generated documentation can be found at godoc.org
Examples
Please checkout the dedicated repository streamdeck-examples for examples.
My personal library of streamdeck elements / buttons can be found in the streamdeck-buttons repository.
Credits
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.
This was forked from the version by dh1tw and then modified in various ways.