Decks sub-actions¶

Deck item set background¶

Changes the background colour or picture of a deck button.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Item	The button's name as you set it on the Decks page. The default %deckItemName% means the button that was just pressed, which works when this action was started by a deck button. Starts as: `%deckItemName%`.
Color	A colour as a hex code like #FF0000 or a colour name like red. Leave empty to keep the current colour.
Image URL	A web link to a picture to use as the background. Leave empty to keep the current one.
State	Which look of the button to change: 0 is its normal look, 1 is its second (active) look. A button can have more looks; use their numbers. Starts as: `0`.

Type id: decks.itemSetBackground

Changes the little icon on a deck button, for example to show a check mark when something is on.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Item	The button's name as you set it on the Decks page. The default %deckItemName% means the button that was just pressed, which works when this action was started by a deck button. Starts as: `%deckItemName%`.
Color	The icon's colour, as a hex code like #FFFFFF or a colour name. Leave empty to keep the current one.
Icon name	The name of a free icon from the Iconify website, like mdi:home. Leave empty to keep the current icon.
Icon image URL	A web link to a picture to use as the icon. If you fill this in, it is used instead of the icon name. Leave empty to keep the current one.
State	Which look of the button to change: 0 is its normal look, 1 is its second (active) look. A button can have more looks; use their numbers. Starts as: `0`.

Type id: decks.itemSetIcon

Switches a deck button to one of its looks, like its normal look or its active look.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Item	The button's name as you set it on the Decks page. The default %deckItemName% means the button that was just pressed, which works when this action was started by a deck button. Starts as: `%deckItemName%`.
State	The look to show: 0 is normal, 1 is the active look. A button can have more looks; use their numbers. Starts as: `0`.

Type id: decks.itemSetState

Changes the text on a deck button.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Item	The button's name as you set it on the Decks page. The default %deckItemName% means the button that was just pressed, which works when this action was started by a deck button. Starts as: `%deckItemName%`.
Title	The words to show on the button. You can use %variables%. Leave empty to clear the text.
Color	The text colour, as a hex code like #FFFFFF or a colour name. Leave empty to keep the current one.
State	Which look of the button to change: 0 is its normal look, 1 is its second (active) look. A button can have more looks; use their numbers. Starts as: `0`.

Type id: decks.itemSetTitle

Shows a small value in the corner of a deck button, like a counter or a score.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Item	The button's name as you set it on the Decks page. The default %deckItemName% means the button that was just pressed, which works when this action was started by a deck button. Starts as: `%deckItemName%`.
Value	The text or number to show in the corner. You can use %variables%. Leave empty to hide it.
State	Which look of the button to change: 0 is its normal look, 1 is its second (active) look. A button can have more looks; use their numbers. Starts as: `0`.

Type id: decks.itemSetValue

Flips a deck button between its normal look and its active look, like a light switch.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Item	The button's name as you set it on the Decks page. The default %deckItemName% means the button that was just pressed, which works when this action was started by a deck button. Starts as: `%deckItemName%`.

Variables it adds

Variable	What it holds
`%deckItemState%`	The button's look now: 0 normal, 1 active

Type id: decks.itemToggleState

Shows a small pop-up message on every screen where the deck is open. Handy to tell someone on your phone that something happened.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Title	The bold first line of the message.
Description	The text under the title.

Type id: decks.notify

Shows the next page of a deck. After the last page it goes back to the first.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.

Variables it adds

Variable	What it holds
`%deckPageNumber%`	The page now showing, counting from 1

Type id: decks.pageNext

Shows the previous page of a deck. From the first page it goes to the last.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.

Variables it adds

Variable	What it holds
`%deckPageNumber%`	The page now showing, counting from 1

Type id: decks.pagePrevious

Shows a chosen page of a deck.

Setting	What to put in
Deck	The name of your deck (the panel of buttons), as you named it on the Decks page. Required.
Page number	The page number, where 1 is the first page. A number that is too big shows the last page. Starts as: `1`.

Variables it adds

Variable	What it holds
`%deckPageNumber%`	The page now showing, counting from 1

Type id: decks.pageSet