Skip to content

Macros & Actions (wip)

Till edited this page Jun 27, 2020 · 2 revisions

Macros

A macro is a sequence of actions that are being played. A macro can consist of multiple actions.

Actions

An action is a part of a macro. It is responsible for a partial thing to happen. Like a key being pressed or a sound being played. Actions are executed in order from top to bottom. If you "Await execution of this action" is ticked, the next action is being played when the current one is done playing, otherwise, it will continue to the next action without waiting for the previous to finish.

What the purpose of ...

Play a sound

This action will playback a sound file. You can finetune the volume for that specific file, set in and out marks as well as the output device (this comes in handy when doing soundboard check VoiceMeeter & Lunchpad

PlaySound Action


Text to speech

Text to speech, in short TTS, allows you to have your pc read a line of text to you with. The voices that are available are derived from the operating system. Sadly it is not directly possible to read back a text on a target audio device.

TTS Action


Launch application

The launch application actions are very powerful and lets you extend the functionality of Lunchpad almost endlessly. From launching simple applications you can also launch scripts written in any language for example python.

  • "Wait until application is closed / finished" will try to wait for an application or script to close before continuing, useful for scripts.
  • "Windowless if possible" tries to hide the application window, also useful for running scripts
  • "Kill when macro gets stopped" will kill the launched process if you use a "Stop all macros" action

Here is an example on how to run a nodejs script (if node js is installed properly)

Launch App


Hotkey sequence

Switch active page

This action will allow you to switch the whole launchpads surface to another page (i.e. giving you a whole new canvas to play). This gives you almost an unlimited amount of macro buttons to work with.

You need to create additional pages on the "Pages" tab in the lunchpad settings dialog.

Switch Page

Flip flop

The flip flop action is a control-flow node and will alternate between its "A" actions and "B" actions. This will allow you to implement toggle like behavior, for example, mute/unmute your microphone and toggle the button color to red/green.

Only one flip-flop per macros pressed and released state can be used

Flip Flop

Push to talk

Set button color

This action will change its owning buttons color to another color (this will change the color you did set up in the appearance tab) Can be used to in conjunction with a flip flop to indicate the flip flop state

SetColor

Delay

This action will add a delay of x millisecond to the action chain.

Delay

Stop ALL macros

This action will stop ALL running macros.

Stop this macro

This action will only stop the pressed buttons macros. Good for stopping looped sounds when you release a button.

Restart this macro

This action will stop the current buttons macros and will then run the macro again. For example if you want to restart a sound each time you press a button.