Skip to main content

MA2 Plugins

A collection of professional Lua plugins designed to streamline your workflow on GrandMA2 lighting consoles. These plugins automate repetitive programming tasks, generate complex effects, and help you work faster during tech and show preparation.

Plugin Collection

Color Picker Update

Automatically creates color presets, sequences, and cues for up to 7 groups with 11 color swatches from the gel library

Pulse Generator

Creates automated pulse sequences with interleaved MAtricks patterns for dynamic bump effects

Pulse Wave Generator

Generates complex wave patterns with directional delays in left, right, in, out, or random modes

Flyout Width

Quickly adjusts flyout effect width parameters and updates associated macros

Color Sweep Update

Updates delay sweep presets for multiple rows with horizontal and vertical fan patterns

Quick Start

Ready to get started? Follow these steps:
1

Install the Plugins

Copy the .lua and .xml files to your console’s plugin directoryView Installation Guide →
2

Run Your First Plugin

Load and execute the Color Picker Update plugin to see how it worksFollow the Quickstart →
3

Explore Plugin Features

Learn the capabilities of each plugin and customize parameters for your rig

Plugin Details

Color Picker Update

Automates the creation of color presets and sequences for multiple fixture groups. The plugin:
  • Creates 11 color presets per group (White, Red, Orange, Yellow, Green, Cyan, Lavender, Blue, Violet, Magenta, Pink)
  • Generates sequences and cues for each group
  • Assigns sequences to executors on page 100
  • Uses GrandMA2’s gel library color swatches for consistent color matching
Use Case: Perfect for setting up color pickers during pre-production or when adding new fixture groups to your show.

Pulse Generator

Creates dynamic pulse effects using MAtricks interleaving:
  • Supports custom group, sequence, and executor numbers
  • Configurable wing modes for symmetric patterns
  • Optional random fixture selection order
  • White bump mode for strobe-style effects
  • Adjustable trigger time and fade time
Use Case: Ideal for creating chase effects, bump cues, or sequenced flashing patterns during high-energy moments.

Pulse Wave Generator

The most advanced plugin in the collection, generating sophisticated wave patterns:
  • Directions: Left, Right, In (center-out), Out (edges-in), or Random
  • Batch Mode: Create waves across multiple groups
  • Single Stack Mode: Merge multiple groups into one cue stack
  • Random Mode: Generates multiple random direction variations
  • Configurable delay, trigger time, and fade parameters
  • Progress bar feedback for long operations
Use Case: Create sweeping waves across your rig for dramatic looks, transitions, or synchronized effects.

Flyout Width

A utility plugin for quickly adjusting flyout effect parameters:
  • Prompts for desired flyout width value
  • Updates the main “Flyout” effect and its half-width variation
  • Refreshes appearance for width macros (25, 50, 100)
  • Updates macro label to reflect current width
Use Case: When you need to adjust effect spread on-the-fly without diving into effect parameters.

Color Sweep Update

A professional delay preset generator created by Jason Giaffo (Giaffo Designs):
  • Creates 54 delay presets (500-553) for sweep effects
  • Supports multiple row groups for vertical rigs
  • Generates 9 sweep types: >>, <<, <<>>, >><<, Up, Down, V. Out, V. In, Shuffle
  • Configurable delay times: 0s, 0.25s, 0.5s, 1s, 2s, 5s
  • Optional wing doubling for consistent wavelength
  • Progress bar feedback during preset creation
Use Case: Essential for creating professional delay sweep effects on matrix rigs or linear fixtures.
All plugins include built-in cleanup functions and reset default values after execution to ensure clean operation.

Features

  • Blind Edit Mode: Plugins automatically enable blind edit to prevent disrupting live output
  • Feedback Messages: Real-time console feedback keeps you informed of progress
  • Error Handling: Plugins validate input and reset values after execution
  • GrandMA2 API: Uses official gma Lua API for stable, reliable operation

System Requirements

  • GrandMA2 console or onPC software
  • Software version 3.0.187 or higher (3.2.2+ recommended for Color Sweep Update)
  • Basic understanding of groups, presets, sequences, and executors

Getting Help

If you encounter issues or have questions:
  1. Check that your console software version is compatible
  2. Verify that files are in the correct plugin directory
  3. Review console feedback messages for specific error information
  4. Ensure your show file has the required groups before running plugins
Always test plugins in a safe programming environment before using during live shows. Some plugins delete and recreate presets and sequences.

Credits

  • Color Picker Update, Pulse Generator, Pulse Wave Generator, Flyout Width: Created by Hugo Otth (2025)
  • Color Sweep Update: Created by Jason Giaffo, Giaffo Designs (2019)

Ready to install? Continue to the Installation Guide.

Build docs developers (and LLMs) love