Stream Deck sub-actions¶
Set key picture¶
Changes the picture on a Stream Deck key. Handy to show an icon that tells whether something is on.
| Setting | What to put in |
|---|---|
| Button ID | The button ID of the key, as shown in the key's settings in Stream Deck and on the Stream Deck page, like "ShoutOut". Keys with the same ID change together. You can use %variables%, like %buttonId%. |
| Image | A picture file on your computer (PNG, JPEG, GIF, SVG, WebP or BMP, up to 2 MB), a web link starting with http, or a data: link. Leave empty to bring back the key's own picture. |
| State | Which of the key's two looks to change. Current changes the one showing now; 0 is the first and 1 the second. Options: Current, 0, 1. Starts as: Current. |
Variables it adds
| Variable | What it holds |
|---|---|
%streamDeckButtons% |
How many keys on screen were changed |
Type id: streamDeck.setBackground
Set key value¶
Shows a value, like a number or a name, on a key or on a dial's touch strip. Good for live counters.
| Setting | What to put in |
|---|---|
| Button ID | The button ID of the key, as shown in the key's settings in Stream Deck and on the Stream Deck page, like "ShoutOut". Keys with the same ID change together. You can use %variables%, like %buttonId%. |
| Value | The text to show: on a key it replaces the title, on a dial it shows on the touch strip. You can use %variables%. |
| Indicator (dials) | For dials only: how full the dial's bar is, from 0 to 100. Leave empty to leave the bar alone. |
Variables it adds
| Variable | What it holds |
|---|---|
%streamDeckButtons% |
How many keys on screen were changed |
Type id: streamDeck.setValue
Set State¶
Sets a two-state key to its first or second look, for example an 'on' and an 'off' picture.
| Setting | What to put in |
|---|---|
| Button ID | The button ID of the key, as shown in the key's settings in Stream Deck and on the Stream Deck page, like "ShoutOut". Keys with the same ID change together. You can use %variables%, like %buttonId%. |
| State | 0 is the first look and 1 is the second look. Options: 0, 1. Starts as: 0. |
Variables it adds
| Variable | What it holds |
|---|---|
%streamDeckButtons% |
How many keys on screen were changed |
Type id: streamDeck.setState
Set Title¶
Changes the text written on a Stream Deck key.
| Setting | What to put in |
|---|---|
| Button ID | The button ID of the key, as shown in the key's settings in Stream Deck and on the Stream Deck page, like "ShoutOut". Keys with the same ID change together. You can use %variables%, like %buttonId%. |
| Title | The words to show on the key. You can use %variables%. Leave empty to bring back the key's own text. |
| State | Which of the key's two looks to change. Current changes the one showing now; 0 is the first and 1 the second. Options: Current, 0, 1. Starts as: Current. |
Variables it adds
| Variable | What it holds |
|---|---|
%streamDeckButtons% |
How many keys on screen were changed |
Type id: streamDeck.setTitle
Show Alert¶
Makes a key flash a warning sign for a moment, to show that something went wrong.
| Setting | What to put in |
|---|---|
| Button ID | The button ID of the key, as shown in the key's settings in Stream Deck and on the Stream Deck page, like "ShoutOut". Keys with the same ID change together. You can use %variables%, like %buttonId%. |
Variables it adds
| Variable | What it holds |
|---|---|
%streamDeckButtons% |
How many keys on screen were changed |
Type id: streamDeck.showAlert
Show Ok¶
Makes a key flash a check mark for a moment, to show that something worked.
| Setting | What to put in |
|---|---|
| Button ID | The button ID of the key, as shown in the key's settings in Stream Deck and on the Stream Deck page, like "ShoutOut". Keys with the same ID change together. You can use %variables%, like %buttonId%. |
Variables it adds
| Variable | What it holds |
|---|---|
%streamDeckButtons% |
How many keys on screen were changed |
Type id: streamDeck.showOk
Toggle State¶
Flips a two-state key to its other look: from the first to the second, or back.
| Setting | What to put in |
|---|---|
| Button ID | The button ID of the key, as shown in the key's settings in Stream Deck and on the Stream Deck page, like "ShoutOut". Keys with the same ID change together. You can use %variables%, like %buttonId%. |
Variables it adds
| Variable | What it holds |
|---|---|
%streamDeckButtons% |
How many keys on screen were changed |
Type id: streamDeck.toggleState