MainStage User Guide
- Welcome
-
- Overview of Edit mode
-
- Select patches and sets in the Patch List
- Copy, paste, and delete patches
- Reorder and move patches in the Patch List
- Add and rename patches
- Create a patch from several patches
-
- Overview of the Patch Settings Inspector
- Select patch settings in the Patch Library
- Set the time signature for patches
- Change the tempo when you select a patch
- Set program change and bank numbers
- Defer patch changes
- Instantly silence the previous patch
- Change patch icons
- Transpose the pitch of incoming notes for a patch
- Change the tuning for a patch
- Add text notes to a patch
-
- Overview of channel strips
- Add a channel strip
- Change a channel strip setting
- Configure channel strip components
- Show signal flow channel strips
- Hide the metronome channel strip
- Create an alias of a channel strip
- Add a patch bus
- Set channel strip pan or balance positions
- Set channel strip volume levels
- Mute and solo channel strips
- Use multiple instrument outputs
- Use external MIDI instruments
- Reorganize channel strips
- Delete channel strips
-
- Overview of the Channel Strip Inspector
- Choose channel strip settings
- Rename channel strips
- Change channel strip colors
- Change channel strip icons
- Use feedback protection with channel strips
- Set keyboard input for a software instrument channel strip
- Transpose individual software instruments
- Filter MIDI messages
- Scale channel strip velocity
- Set channel strips to ignore Hermode tuning
- Override concert- and set-level key ranges
- Add text notes to a channel strip in the Channel Strip Inspector
- Route audio via send effects
-
- Screen Control Inspector overview
- Replace parameter labels
- Choose custom colors for screen controls
- Change background or grouped screen control appearance
- Set screen controls to show the hardware value
- Set parameter change behavior for screen controls
- Set hardware matching behavior for screen controls
- Reset and compare changes to a patch
- Override concert- and set-level mappings
-
- Overview of mapping screen controls
- Map to channel strip and plug-in parameters
- Map screen controls to actions
- Map a screen control to multiple parameters
- Use screen controls to display PDF document pages
- Edit the saved value for a mapped parameter
- Set drum pads or buttons to use note velocity
- Map screen controls to all channel strips in a patch
- Undo screen control parameter mappings
- Remove screen control mappings
- Work with graphs
- Create controller transforms
- Share patches and sets between concerts
- Record the audio output of a concert
-
- Overview of concerts
- Create a concert
- Open and close concerts
- Save concerts
- How saving affects parameter values
- Clean up concerts
- Consolidate assets in a concert
- Rename the current concert
-
- Overview of the Concert Settings Inspector
- Set MIDI Routing to channel strips
- Transpose incoming note pitch for a concert
- Define the program change message source
- Send unused program changes to channel strips
- Set the time signature for a concert
- Change the tuning for a concert
- Set the pan law for a concert
- Add text notes to a concert
- Control the metronome
- Silence MIDI notes
- Mute audio output
-
- Layout mode overview
-
- Screen control parameter editing overview
- Lift and stamp screen control parameters
- Reset screen control parameters
- Common screen control parameters
- Keyboard screen control parameters
- MIDI activity screen control parameters
- Drum pad screen control parameters
- Waveform screen control parameters
- Selector screen control parameters
- Text screen control parameters
- Background screen control parameters
- How MainStage passes through MIDI messages
- Export and import layouts
- Change the aspect ratio of a layout
-
- Before performing live
- Use Perform mode
- Screen controls in performance
- Tempo changes during performance
- Tips for performing with keyboard controllers
- Tips for performing with guitars and other instruments
- Tune guitars and other instruments with the Tuner
- The Playback plug-in in performance
- Record your performances
- After the performance
- Tips for complex hardware setups
-
- Overview of keyboard shortcuts and command sets
-
- Concerts and layouts keyboard shortcuts
- Patches and sets (Edit mode) keyboard shortcuts
- Editing keyboard shortcuts
- Actions keyboard shortcuts
- Parameter mapping (Edit mode) keyboard shortcuts
- Channel strips (Edit mode) keyboard shortcuts
- Screen controls (Layout mode) keyboard shortcuts
- Perform in Full Screen keyboard shortcuts
- Window and view keyboard shortcuts
- Help and support keyboard shortcuts
-
-
- Use MIDI plug-ins
-
- Arpeggiator overview
- Arpeggiator control parameters
- Note order parameters overview
- Note order variations
- Note order inversions
- Arpeggiator pattern parameters overview
- Use Live mode
- Use Grid mode
- Arpeggiator options parameters
- Arpeggiator keyboard parameters
- Use keyboard parameters
- Assign controllers
- Modifier controls
- Note Repeater controls
- Randomizer controls
-
- Use Scripter
- Use the Script Editor
- Scripter API overview
- MIDI processing functions overview
- HandleMIDI function
- ProcessMIDI function
- GetParameter function
- SetParameter function
- ParameterChanged function
- Reset function
- JavaScript objects overview
- Use the JavaScript Event object
- Use the JavaScript TimingInfo object
- Use the Trace object
- Use the MIDI event beatPos property
- Use the JavaScript MIDI object
- Create Scripter controls
- Transposer controls
-
-
- Alchemy overview
- Alchemy interface overview
- Alchemy Name bar
- Alchemy file locations
-
- Alchemy source overview
- Source master controls
- Import browser
- Source subpage controls
- Source filter controls
- Source filter use tips
- Source elements overview
- Additive element controls
- Additive element effects
- Spectral element controls
- Spectral element effects
- Pitch correction controls
- Formant filter controls
- Granular element controls
- Sampler element controls
- VA element controls
- Wide unison mode
- Source modulations
- Morph controls
- Alchemy master voice section
- Alchemy Extended parameters
-
- Playback plug-in overview
- Add a Playback plug-in
- Playback interface
- Use the Playback waveform display
- Playback transport and function buttons
- Playback information display
- Playback Sync, Snap To, and Play From parameters
- Use the Playback group functions
- Use the Playback Action menu and File field
- Use markers with the Playback plug-in
-
- Sample Alchemy overview
- Interface overview
- Add source material
- Edit mode
- Play modes
- Source overview
- Synthesis modes
- Granular controls
- Additive effects
- Additive effect controls
- Spectral effect
- Spectral effect controls
- Filter module
- Lowpass, bandpass, and highpass filters
- Comb PM filter
- Downsampler filter
- FM filter
- Envelope generators
- Mod Matrix
- Modulation routing
- Motion mode
- Trim mode
- More menu
-
- Sculpture overview
- Sculpture interface
- Global parameters
- Amplitude envelope parameters
- Use the Waveshaper
- Filter parameters
- Output parameters
- Define MIDI controllers
- Extended parameters
-
- Studio Piano
- Copyright and trademarks
Sample Alchemy sources in MainStage
Sample Alchemy sound-generating modules are called sources. Four independent sources (labeled A/B/C/D) are available in each preset, and each source has an identical set of controls.
Source components are shown when you click the A, B, C, and D buttons to select the source you want to edit. Some parameters can be set globally or per source. Global parameters override individual source settings.
The components in each source are displayed in three modules: source, synthesis, and filter.

Sample Lock button: Click the lock to keep the current sample when changing presets.
Sample pop-up menu: Load a new sample, export the current sample, or show the current sample in the Finder.
Source buttons: Turn a source on or off. When turned on, a source is a sound-generating module indicated by a handle labeled A/B/C/D that is positioned on the waveform.
Mixer button: Show or hide the mixer pane. The mixer lets you adjust the volume for each source.
Mixer sliders: Adjust the volume for each source. A dot indicates which source you’re currently adjusting.
Snap pop-up menu: Choose a Snap value. If you select the Play or Motion edit mode, the Snap value affects the movement of source handles. In Trim mode, the Snap value affects edits to loop start and end markers in the waveform display. The following options are available in the Snap pop-up menu:
Auto: The Snap value is automatically set to the best value based on the selected mode and the sample.
Off: Turn snap off.
Transients: Snap to transients in the sample.
Beat: Snap to beat values in the sample.
Fixed: Set the Snap value to allow source handles to move only on the Y axis (vertically) in play modes and Motion mode.
Zoom button: Tap Zoom to access the horizontal zoom slider. Drag left or right to view a specific waveform section, or adjust the slider’s handles for more or less detail.
Mod Matrix button: Show or hide the Mod Matrix pane, which you can use to assign up to four independent routings of modulation to a target.
Source handles: Click the handles labeled A/B/C/D to hear the sample preview. Drag left or right to adjust the playback position, and drag up or down to adjust the first parameter in the source module. When preview mode is turned on in the More menu settings and you click a handle, Sample Alchemy plays a single MIDI note that you can record to a MIDI region in Logic Pro. See Sample Alchemy More menu in MainStage. You can record handle movements using automation or directly in Sample Alchemy using Motion mode. See Record handle movements to a MIDI region and Sample Alchemy Motion mode in MainStage.
Source module: Adjust the parameters for the selected source. The first parameter available here changes depending on the selected play mode. For example, in Classic mode you can control the speed at which the sound is played, and in Loop mode you can control the loop speed. The other parameters in this column let you set the panning and tuning for each source.
Source pop-up menu: Choose the source (A/B/C/D) you want to edit, or choose Select All to edit all sources.
Synthesis module: Choose from multiple sound-generating modes based on different methods of synthesis. Here you can set a synthesis mode for each source. See Sample Alchemy synthesis modes.
Filter module: Set the filter for each source or globally. See Sample Alchemy filters.
Source module parameters
Playback Speed knob: Set the sample playback speed of the sample. Set low speed values to create gradually evolving textures.
Playback Speed Sync button: Turn on to synchronize the playback speed with the project tempo. Turn off to freely set the playback speed. This button is active only when the loaded sample contains tempo information.
Loop Speed knob: Set the sample loop speed between the start point and end point.
Loop Speed Sync button: Turn on to synchronize the loop speed with the project tempo. Turn off to freely set the loop speed. This button is active only when the loaded sample contains tempo information.
Scrub Jitter knob: Set the depth of the jitter action.
Bow Rate knob: Set the rate of the bow action.
Bow Rate Sync button: Turn on to set the rate in tempo-synced note values instead of Hz. Turn off to freely set the bow rate.
Arp Rate knob: Set the duration of the arpeggiator steps. The arpeggiator is synchronized with the project tempo, and the Rate is set from whole notes (1) to 1/32 notes. Dotted and triplet subdivisions provide more complex and expressive rhythmic patterns.
Pan knob: Set the source output position in the stereo field.
Tune Coarse knob: Tune the selected source in semitone increments.
Tune Fine knob: Tune the selected source pitch in cent increments.
Turn on a source in Sample Alchemy
Click a source button (A/B/C/D) to turn on a source.
Turn off a source in Sample Alchemy
Click a highlighted source button (A/B/C/D) to turn off a source.
Select a source in Sample Alchemy
Click a source handle (A/B/C/D) to select a source.
Select multiple sources in Sample Alchemy
Click the Source menu on the lower left side of Sample Alchemy, then choose Select All.
Mix sources in Sample Alchemy
Click the Mixer button on the upper-left side of Sample Alchemy, then drag a volume level up or down.
Record handle movements to a MIDI region
Select the track that has the Sample Alchemy plug-in loaded.
Open the Sample Alchemy plug-in window with a sample loaded.
In the Track inspector, ensure that the Internal MIDI In > Instrument Output submenu has this track selected.
Start recording your project and move the handles in Sample Alchemy.
The MIDI region records a MIDI note every time you click a handle, and the movement of the handle is recorded as region automation.