Command Deck advanced
Go further with Command Deck: build sequences of up to ten steps, call web addresses, run saved workflows, set hotkeys and edit a button's advanced settings.
Live and chatLast updated
This page covers the Command Deck options for when one action is not enough. If you have not made a button yet, start with Command Deck.
Sequences#
A sequence runs up to ten steps in order from one press. Choose Run a sequence as the action type, then add steps.
- For each step, choose a Step type: control a widget, call a web address or run a saved workflow.
- Set up the step in the same way as a button of that type.
- Use the arrows to move a step up or down, and remove steps you do not need.
Steps cannot be nested, so a step cannot run another sequence. There is no delay step.
There is no undo. A later step can still run after an earlier one fails, and steps that already ran stay done. Read the run result before you press the button again.
Web addresses#
Choose Call a web address to send a request to another service when you press the button.
- Web address: the full address, such as
https://your-service.example/action. - HTTP method: POST unless you choose another: GET, PUT, PATCH, DELETE, HEAD or OPTIONS.
- Timeout (seconds): how long to wait for an answer, from 0.1 to 30.
To add headers or a body, use the advanced settings below. Running the button sends a real request. Keep any credentials private.
Saved workflows#
Choose Run a saved workflow, then pick one from Saved workflow. A summary tells you how it behaves:
- Runs only when you press a button, or Also starts automatically if it has its own trigger.
- Automatic start is off. You can still run it from a button. A button can run a workflow even when its own trigger is off.
- Whether every step also works when the workflow starts automatically, or only when you run it from a button.
Only workflows that a button can run appear in the list. Bearsong does not create workflows from here. If none fit, choose Build a sequence to make a sequence of widget controls and web address calls instead.
Hotkeys#
Give a button a hotkey in Appearance and shortcut. A hotkey is a letter, digit or F1 to F12, with optional modifier keys.
To use hotkeys, open Hotkey settings on the deck and switch on Enable hotkey prompts in this tab. The setting is for the browser tab you are in.
- A hotkey opens the same confirmation as a click. It never runs a button on its own.
- Hotkeys pause while you type, edit a button or confirm a run.
- Hotkeys can open hidden buttons in any deck.
- If two buttons share a hotkey, Bearsong asks you to change one of them before it works.
Advanced settings#
Advanced settings in the editor shows All settings (JSON) for the button. Use it for anything the guided fields do not cover, such as web address headers.
Editing it replaces this button's settings only. Settings Bearsong does not recognise are kept unless you remove them. The limit is 64 KB. If the JSON is not valid, the guided fields ask you to fix it before you can use them again.
#
- Pinned chat message can Unpin the message or Keep it pinned longer, with Pin for (seconds, from now).
You can keep and edit these buttons, but you cannot choose this type for a new one.