24.2 Comment Macros

You can use comment macros to automate tasks on the console such as:

Comment macros can be configured to run at these times:

Comment Macros are text commands that you type or place into a macro cell; the syntax used is the same in each case:

Controlling Masters
Comment Macro Syntax Example Notes
Go Master GM[master]/[cue] GM1/3 Use ‘*’ for the current chosen master. If you omit the cue number, the next cue will Go.
Go Master GM[range] GM2>7 Go next cue on a range of masters.
Halt Master HM[master or range] HM1,3:HM2>7  
Assert Master AM[master or range] AM1:AM2>7  
Release Master RM[master or range] RM1:RM2>7  
Release All RA RA Equivalent to Pig + Release.
Release Others RO RO Releases all masters except the one with the macro.
Fade Master FM[master]/[level][timing] FM2/50t2 Fades master 2 to 50% in 2 seconds. To fade in 0s omit the timing portion of the macro.
Fade Grand Master FGM[level][timing] FGM10t3 Fades the grand master to 10% in 3 seconds. To fade the grand master in 0s omit the timing portion of the macro.
Choose Master CM[master] CM1  
Controlling Cuelists
Comment Macro Syntax Example Notes
Go Cuelist GL[list]/[cue] GL1.5, GL2/5 If you omit the cue number, the next cue will Go.
Halt Cuelist HL[list] HL1,6  
Assert Cuelist AL[list] AL10  
Release Cuelist RL[list] RL4,7,9  
Controlling Batches
Comment Macro Syntax Example Notes
Go Batch GB[batch] GB12  
Halt Batch HB[batch] HB1  
Assert Batch AB[batch] AB10  
Release Batch RB[batch] RB4  
Controlling Scenes
Comment Macro Syntax Example Notes
Go Scene GS[scene] GS12 
Halt Scene HS[scene] HS4 
Assert Scene AS[scene] AS1 
Release Scene RS[scene] RS6,20 
Controlling Pages, Playback Bars, and Views
Comment Macro Syntax Example Notes
Change Page CP[page] CP3  
Next Page CP+ CP+ Goes to the next page in the Page Directory, skipping the template page and blank pages.
Previous Page CP- CP- Goes to the previous page in the Page Directory, skipping the template page and blank pages.
Recall View RV[view] RV2  
Dock Playback Bar DPB# DPB2Docks the specified playback bar to its docking assignment.
Controlling Timecode
Comment Macro Syntax Example Notes
Enable Timecode ET[cuelist] ET2 Enables timecode for the selected cuelist.
Disable Timecode DT[cuelist] DT2  
Open Timecode Toolbar OT[node type][node number] OTh1 When DP8000 is specified as the node type then an index number is also required; example: OTd1/1
Enabling / Disabling Clock Triggers
Comment Macro Syntax Example Notes
Enable Clock EC[cuelist] EC2Enables clock triggers for Cuelist 2
Disable Clock DC[cuelist] DC2Disables clock triggers for Cuelist 2
Sending MIDI strings
Comment Macro Syntax Example
MIDI String MS[node type][node number]/[MIDI message] MSh1/90 47 3F
Midi strings can be used to send System Exclusive Midi Messages or Midi Note Messages but must be written using hex values (see Decimal to Hex Conversion Chart). Listed below is a break down of how a midi string comment macro would be formatted for sending a midi note: MSh1 - indicates midi string will be sent from Hog Console with net number 1 [ forward slash ] 9 - indicates note on (8 indicates note off) 0 - midi channel number (0 in hex = 0 in decimal) [ SPACE ] 47 - midi note number (47 in hex = 71 in decimal) [ SPACE ] 3F - velocity (3F in hex = 63 in decimal) A simpler method for sending midi notes via comment macros is explained in the "sending midi notes" section below.
Sending MIDI Notes
Comment Macro Syntax Example
MIDI Note MN[reference to entry] MNGoLaser
In order to utilize midi note comment macros the user must first create entries in the "Midi Notes" window which can be opened by holding the Open key on the front panel and selecting the "Midi Notes" button on the open toolbar. Once a midi note message entry has been created in the Midi Note Window it will appear in the comment macro drop down menu for cues, scenes, and pages. If the details of a midi note entry are changed in the midi note window then any cues and scenes, or pages referencing that entry will also be updated.
Controlling Network Devices
Comment Macro Syntax Example Notes
Reset Node [node type][net number] RNH3 Resets the selected network device, such as a DMX Processor. For the device type, use the following letter codes: H for Wholehog, D for DMX Processor .
Controlling Keystroke Macros
Macro Syntax Example Notes
GK GK [macro number] GK2 Runs Macro 2
HK HK [macro number] HK2 Pauses Macro 2
RK RK [macro number] RK2 Stops Macro 2

You can display and select from a list of available macro commands on the console by selecting the Macro cell and pressing the Set key.

24.2.1 Entering Comment Macro Commands

To enter a comment macro command into a macro cell:

  1. Select the macro cell, and press Set.

  2. Select a command from the drop down menu.

  3. Enter the specific information for the macro, such as the master number.

  4. Press Enter to finish or select another macro and repeat. If you add a further macro command, the ‘:’ will be entered automatically.


  1. Select the macro cell, and press Set.

  2. Enter the macro command manually using the keyboard.

  3. Press Enter to finish.

Note that if you enter an invalid command, then the cell will revert to being empty when you press Enter.

24.2.2 Additional Comment Macro Syntax

For some comment macro commands such as fading masters you can specify the execution timing of the macro by adding a "t" followed by a numerical value in seconds:

  • FM10/1t10

Also within a comment macro command, you can specify multiple targets separated with commas:

  • RS6,20

or a range with a right angle-bracket:

  • HM2>7

You can have multiple comment macros executed by one cue by separating them with colons:

  • HM1,3:HM2>7

You can also send commands to a specified network device, using H (Hog) to refer to a console, D to refer to a DMX Processor, and IOP to refer to an MIDI/Timecode Processor. For example:

  • GM1H2 : will Go master 1 on console number 2.

  • RND3 : will reset DMX Processor number 3.