rafaelmartins.com/p/streamdeck

Stream Deck Go Library

A pure Go library for interacting with Elgato Stream Deck devices. This library works on Linux, macOS, and Windows.

[!IMPORTANT] Disclaimer: This library is NOT supported or endorsed by Elgato, Corsair, or any related company. Use it at your own risk!

Features

• Cross-platform support - Works on Linux, macOS, and Windows
• Pure Go implementation - No libusb/hidapi dependency
• Multiple device support - Supports various Stream Deck models
• Input event handling - Register callbacks for input events
• Image display - Set custom images on keys with automatic scaling
• Touch point control - Set colors for touch points on supported models
• Info bar support - Control the info bar display on supported models
• Touch strip support - Control the touch strip display on supported models
• Device management - Control brightness, reset, and get device information

Supported Devices

Model	Product ID	Keys	Touch Points	Dials	Info Bar	Touch Strip
Stream Deck Mini	0x0063	6	❌	❌	❌	❌
Stream Deck V2	0x006d	15	❌	❌	❌	❌
Stream Deck MK.2	0x0080	15	❌	❌	❌	❌
Stream Deck Plus	0x0084	8	❌	4	❌	✅
Stream Deck Neo	0x009a	8	2	❌	✅	❌

Supporting additional models would require hardware access for the library maintainer. Adding support based purely on data reverse-engineered from other libraries is not an option. If you have the means to support adding more devices, please contact the maintainer for additional information.

Motivation

This work started as an internal library for the mister-macropads project, which was never published there. The API worked out so nicely that I decided to make it a standalone public library.

The design is heavily inspired by the client library for my open hardware macropad octokeyz (rafaelmartins.com/p/octokeyz), and it relies on my pure Go USB HID library (rafaelmartins.com/p/usbhid).

Being pure Go makes it easier to cross-compile for restricted environments, like the MiSTer FPGA Linux-based operating system. The library also strives to implement and consume the interfaces defined by Go standard libraries for improved compatibility.

This library does not have any tooling to generate images; users are encouraged to generate any image.Image and the library will make it fit the desired viewport. There are Get*ImageRectangle() functions to recover the geometry of the viewport if users want to generate images the right size and avoid scaling.

Installation

go get rafaelmartins.com/p/streamdeck

Quick Start

package main

import (
	"image/color"
	"log"

	"rafaelmartins.com/p/streamdeck"
)

func main() {
	// get the first available stream deck device
	devices, err := streamdeck.Enumerate()
	if err != nil {
		log.Fatal(err)
	}
	if len(devices) == 0 {
		log.Fatal("No Stream Deck devices found")
	}
	device := devices[0]

	// open the device
	if err := device.Open(); err != nil {
		log.Fatal(err)
	}
	defer device.Close()

	// set key 1 to red
	red := color.RGBA{255, 0, 0, 255}
	if err := device.SetKeyColor(streamdeck.KEY_1, red); err != nil {
		log.Print(err)
		return
	}

	// add a key handler
	if err := device.AddKeyHandler(streamdeck.KEY_1, func(d *streamdeck.Device, k *streamdeck.Key) error {
		log.Printf("Key %s pressed!", k)
		duration := k.WaitForRelease()
		log.Printf("Key %s released! %s", k, duration)
		return nil
	}); err != nil {
		log.Print(err)
		return
	}

	// listen for input events
	if err := device.Listen(nil); err != nil {
		log.Print(err)
		return
	}
}

API Reference

Please check pkg.go.dev/rafaelmartins.com/p/streamdeck for complete API documentation.

Examples

See the examples directory for complete working examples:

• Basic Usage - Simple input handling and image setting with complete error handling
• Advanced Features - Info bar, touch points, dials, touch strip, long press detection, and dynamic effects
• Image Examples - Different ways to set images including embedded files, patterns, and generated graphics
• Device Information - Device enumeration, capability detection, and information retrieval
• Multi-Device - Working with multiple Stream Deck devices simultaneously with synchronized effects

Running Examples

Each example is a complete, standalone program. To run them:

# Basic usage example (pass a serial number as argument if multiple devices connected)
go run examples/basic/main.go

# Advanced features (pass a serial number as argument if multiple devices connected. requires a device with info bar/touch points for full demo)
go run examples/advanced/main.go

# Image examples with patterns and embedded icons (pass a serial number as argument if multiple devices connected)
go run examples/images/main.go

# Device information and enumeration
go run examples/device-info/main.go

# Multi-device synchronization (requires multiple devices for full demo)
go run examples/multi-device/main.go

License

This library is distributed under a BSD 3-Clause license.