Macros

Macros let you record a sequence of commands and replay them with a single action. They are useful for repetitive tasks, startup routines, or complex multi-step operations that you want to trigger quickly.

Recording a macro

Start recording:

macro record 1 "Startup Routine"

Now execute the commands you want to capture (they also run live while recording):

dmx startmaster 0 value 1.0go 1

Stop recording:

macro stop

All commands issued between macro record and macro stop are saved into macro slot 1.

Running a macro

macro run 1

phix replays each recorded command in sequence.

Macro steps with delays

When a macro is recorded, each step can have an optional delay before it executes. Edit delays via the command line:

macro 1 step 2 delay 1.5    -- wait 1.5 seconds before step 2

Listing macros

list macros

Deleting a macro

macro delete 1

Using macros with MIDI or OSC

Macros can be triggered from MIDI or OSC bindings, making them useful for complex one-button operations from a hardware controller:

midi map note 0 10 "macro run 1"osc bind /phix/startup "macro run 1"

Example macros

Startup routine:

macro record 1 "Startup"dmx startautosave on 5master 0 value 1.0macro stop

End-of-show blackout:

macro record 2 "End Show"release 1release 2master 0 value 0macro stop