====== Stream Deck ======

The [[https://www.elgato.com/en/gaming/stream-deck|Elgato Stream Deck]] is an external keypad/keyboard with a number of programable buttons.

Keyboard Maestro (v9.0+) supports the Stream Deck via an Stream Deck Plug In and the [[trigger:USB_Device_Key|USB Device Key]] trigger, as well as a number of Stream Deck specific actions.

===== Installation======

Ensure you have Stream Deck 4.2 or later installed.

The Keyboard Maestro Stream Deck Plug In is available directly from the Stream Deck `More Actions…` button.

===== Configuration =====

For any button you want to use with Keyboard Maestro, drag the resulting Keyboard Maestro entry (in the Automation category) to a button.

In Stream Deck, you can configure the button:

{{ action:stream-deck-button-detail.png?nolink&494x208 | Stream Deck Button Detail }}

You can configure the position and font and size of the title which appears in the button, as well as the title of the button.

The button also has an ID which is how you refer to it from Keyboard Maestro actions, as well as a row and column number which is how the button appears to the USB Device Key trigger.  By default these will track the position of the button on the keyboard, and you should probably leave them all blank unless you have specific needs. If you wish the button to remain triggering the same macro when you move it, you should set the row and column explicitly. Also, if you have multiple Stream Deck Profiles, and buttons on different profiles that are intended to trigger different macros, then you should set the row and column uniquely in each Profile.

Since the button works the same as any other USB Device Key trigger, you can detect press, release, tap, tap twice, and so forth, giving you many ways to interact with the button.

And since you can set the title and image on the button from Keyboard Maestro, you can have a lot of feedback on the keyboard as well.

===== See Also =====

==== Actions ====

* [[action:Stream Deck Set Title]]
* [[action:Stream Deck Set Image]]
* [[action:Stream Deck Show OK]]
* [[action:Stream Deck Show Alert]]
* [[:Actions|See all Actions]]