streamdeck

package module
v0.6.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 23, 2026 License: MIT Imports: 13 Imported by: 0

README

streamdeck

Latest Release Software License Build Status Go ReportCard Go Doc

A CLI application and Go library to control your Elgato Stream Deck on Linux.

If you're looking for a complete Linux service to control your StreamDeck, check out Deckmaster, which is based on this library.

Installation

Make sure you have a working Go environment (Go 1.26 or higher is required). See the install instructions.

To install the streamdeck-cli tool, run:

go install github.com/nix-er/streamdeck/cmd/streamdeck-cli@latest

To use streamdeck as a library in your Go module, run:

go get github.com/nix-er/streamdeck

Configuration

On Linux you need to set up some udev rules to be able to access the device as a regular user. Create /etc/udev/rules.d/70-streamdeck.rules with these lines:

# Stream Deck Original, Mini, XL, Original v2, MK.2, Plus, XL v2, Mini MK.2
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0060", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0060", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0063", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0063", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006c", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006c", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006d", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="006d", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0080", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0080", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0084", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0084", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="008f", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="008f", TAG+="uaccess"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0090", TAG+="uaccess"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0fd9", ATTRS{idProduct}=="0090", TAG+="uaccess"

TAG+="uaccess" gives the user logged in on the local seat access to the device, so no extra group membership is needed. The file name must sort before 73-seat-late.rules, or uaccess has no effect. Reload the rules with sudo udevadm control --reload-rules && sudo udevadm trigger. Unplug and replug the device and you should be good to go.

Usage

Control the brightness, in percent between 0 and 100:

streamdeck-cli brightness 50

Set an image on the first key (from the top-left):

streamdeck-cli image 0 image.png

Clear all images:

streamdeck-cli clear

Reset the device:

streamdeck-cli reset

Stream Deck+ dials and touch screen

Device.ReadInput() emits all input events of a device: Key, DialPress, DialTurn (with a signed step count, negative for counterclockwise turns) and Touch (tap, long press or swipe, with screen coordinates). ReadKeys() only emits key events.

events, err := dev.ReadInput()
if err != nil {
	return err
}
for e := range events {
	switch e := e.(type) {
	case streamdeck.Key:
		fmt.Println("key", e.Index, e.Pressed)
	case streamdeck.DialPress:
		fmt.Println("dial", e.Index, e.Pressed)
	case streamdeck.DialTurn:
		fmt.Println("dial", e.Index, "turned", e.Steps)
	case streamdeck.Touch:
		fmt.Println("touch", e.Type, e.X, e.Y)
	}
}

The touch screen (dev.ScreenWidth × dev.ScreenHeight pixels) is split into dev.ScreenSegments segments, one above each dial. Set an image on a segment with dev.SetScreenSegmentImage(index, img), or on any region with dev.SetScreenImage(x, y, img).

Feedback

Got some feedback or suggestions? Please open an issue or drop me a note!

Documentation

Overview

Package streamdeck controls Elgato Stream Deck devices.

Index

Constants

View Source 
const (
	VID_ELGATO              = 0x0fd9
	PID_STREAMDECK          = 0x0060
	PID_STREAMDECK_V2       = 0x006d
	PID_STREAMDECK_MK2      = 0x0080
	PID_STREAMDECK_MINI     = 0x0063
	PID_STREAMDECK_MINI_MK2 = 0x0090
	PID_STREAMDECK_XL       = 0x006c
	PID_STREAMDECK_XL_V2    = 0x008f
	PID_STREAMDECK_PLUS     = 0x0084
)

Stream Deck Vendor & Product IDs.

Variables

This section is empty.

Functions

This section is empty.

Types

type Device 

type Device struct {
	ID     string
	Serial string

	Columns uint8
	Rows    uint8
	Keys    uint8
	Pixels  uint
	DPI     uint
	Padding uint

	// Dials is the number of rotary dials (Stream Deck+).
	Dials uint8

	// ScreenWidth and ScreenHeight are the pixel dimensions of the touch
	// screen strip (Stream Deck+), which is split into ScreenSegments
	// equally sized segments, one above each dial. All zero if the device
	// has no touch screen.
	ScreenWidth    uint
	ScreenHeight   uint
	ScreenDPI      uint
	ScreenSegments uint8
	// contains filtered or unexported fields
}

Device represents a single Stream Deck device.

func Devices 

func Devices() ([]Device, error)

Devices returns all attached Stream Decks.

func (Device) Asleep 

func (d Device) Asleep() bool

Asleep returns true if the device is asleep.

func (Device) Clear 

func (d Device) Clear() error

Clear clears the Stream Deck, setting a black image on all buttons and the touch screen.

func (*Device) Close 

func (d *Device) Close() error

Close the connection with the device.

func (*Device) Fade 

func (d *Device) Fade(start uint8, end uint8, duration time.Duration) error

Fade fades the brightness in or out.

func (Device) FirmwareVersion 

func (d Device) FirmwareVersion() (string, error)

FirmwareVersion returns the firmware version of the device.

func (*Device) Open 

func (d *Device) Open() error

Open the device for input/output. This must be called before trying to communicate with the device.

func (*Device) ReadInput added in v0.6.0 

func (d *Device) ReadInput() (chan Event, error)

ReadInput returns a channel, which it will use to emit all input events: Key, DialPress, DialTurn and Touch. The channel gets closed when reading from the device fails.

func (*Device) ReadKeys 

func (d *Device) ReadKeys() (chan Key, error)

ReadKeys returns a channel, which it will use to emit key presses/releases. Dial and touch screen input is ignored; use ReadInput to receive it.

func (Device) Reset 

func (d Device) Reset() error

Reset resets the Stream Deck, clears all button images and shows the standby image.

func (Device) ScreenSegmentWidth added in v0.6.0 

func (d Device) ScreenSegmentWidth() uint

ScreenSegmentWidth returns the width of a touch screen segment in pixels, or 0 if the device has no touch screen.

func (*Device) SetBrightness 

func (d *Device) SetBrightness(percent uint8) error

SetBrightness sets the background lighting brightness from 0 to 100 percent.

func (Device) SetImage 

func (d Device) SetImage(index uint8, img image.Image) error

SetImage sets the image of a button on the Stream Deck. The provided image needs to be in the correct resolution for the device. The index starts with 0 being the top-left button.

func (Device) SetScreenImage added in v0.6.0 

func (d Device) SetScreenImage(x, y int, img image.Image) error

SetScreenImage sets the image of a region of the touch screen, with its top-left corner at x, y. The image must fit within the screen.

func (Device) SetScreenSegmentImage added in v0.6.0 

func (d Device) SetScreenSegmentImage(index uint8, img image.Image) error

SetScreenSegmentImage sets the image of a touch screen segment. The image needs to be of the segment's size. The index starts with 0 being the leftmost segment.

func (*Device) SetSleepFadeDuration 

func (d *Device) SetSleepFadeDuration(t time.Duration)

SetSleepFadeDuration sets the duration of the fading animation when the device is put to sleep or wakes up.

func (*Device) SetSleepTimeout 

func (d *Device) SetSleepTimeout(t time.Duration)

SetSleepTimeout sets the time after which the device will sleep if no key events are received.

func (*Device) Sleep 

func (d *Device) Sleep() error

Sleep puts the device asleep, waiting for a key event to wake it up.

func (*Device) Wake 

func (d *Device) Wake() error

Wake wakes the device from sleep.

type DialPress added in v0.6.0 

type DialPress struct {
	Index   uint8
	Pressed bool
}

DialPress is emitted when a dial gets pressed or released.

type DialTurn added in v0.6.0 

type DialTurn struct {
	Index uint8
	Steps int8
}

DialTurn is emitted when a dial gets turned. Steps is positive for clockwise and negative for counterclockwise turns.

type Event added in v0.6.0 

type Event interface {
	// contains filtered or unexported methods
}

Event is an input event read from the device: Key, DialPress, DialTurn or Touch.

type Key 

type Key struct {
	Index   uint8
	Pressed bool
}

Key holds the current status of a key on the device.

type Touch added in v0.6.0 

type Touch struct {
	Type       TouchType
	X, Y       uint16
	EndX, EndY uint16
}

Touch is emitted when the touch screen gets tapped, long-pressed or swiped. X and Y are the screen coordinates of the touch, EndX and EndY the end point of a swipe.

type TouchType added in v0.6.0 

type TouchType uint8

TouchType describes the kind of a Touch event. 

const (
	TouchTap TouchType = iota + 1
	TouchLongPress
	TouchSwipe
)

Touch event types.

Source Files

View all Source files

Directories

Path Synopsis
cmd
streamdeck-cli command
Command streamdeck-cli controls Elgato Stream Deck devices from the command line.
 Command streamdeck-cli controls Elgato Stream Deck devices from the command line.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.