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
- 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
- Low and highpass filter
- 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
-
- Copyright
Use the Sampler Zone pane in MainStage
You can see the current waveform of the selected zone and can directly edit a number of sample playback parameters in the Zone pane waveform display. You can zoom in or out with pinch gestures, or scroll the waveform display using two-finger swipes or by dragging the scroll bar. You can use single-finger swipes if you are using a Magic Mouse.
Important: Use of gestures, such as swiping or pinching require these features to be enabled in the Mouse or Trackpad panes of your System Settings.
As you move the pointer across the waveform display, it changes in appearance and function. For example, the pointer will change to indicate that you can move a slice marker or fade marker. In addition, parameters and values related to the current pointer tool function are shown below the waveform display (and in Zone view).
Click or drag markers and handles in the waveform display to change values. Drag vertically in parameter value fields to change them. For example, vertically drag the value shown for Loop Start to change it. Alternatively, you can double-click in a field and enter a value, then press the Return key.
You can also Control-click the waveform display to open a shortcut menu that allows you to open the sample in the Logic Pro Audio File Editor (or an external editor), if you prefer.
Tip: The Zone pane is best used with the Mapping pane also visible. See Mapping and Zone pane overview.
Zone pane parameters
Double-click a parameter value field to enter a new value. Press Return to complete the operation.
Waveform display: Shows the selected zone waveform, marker handles, and shaded marker areas. You can drag the marker handles to adjust zone playback.
Edit menu: Choose an editing command or function. See the task in this section to learn more about the commands and functions in this pop-up menu.
View menu: Choose an option that affects the appearance of the display. See the task in this section to learn more about the commands and functions in this pop-up menu.
Preview button: Play the selected zone.
Snap pop-up menu: Choose a value. Edits to crossfade, sample, fade, or loop markers in the waveform display automatically snap to the nearest possible value.
Zoom vertical button: Switch between the maximum vertical zoom view for the currently displayed waveform section and the default zoom view.
Zoom horizontal button: Switch between the last manually set zoom level, if applicable, and an optimized zoom level that shows the area between the sample start and end markers. When no manual zoom level is set, the entire audio file is shown.
Tip: You can use your trackpad to zoom in or out on the waveform display with pinch gestures, or scroll using two-finger swipes or by dragging the scroll bar. You can use a Magic Mouse to perform the following gestures: one finger horizontal swipe to scroll, or use a one finger vertical swipe to zoom.
Zone pop-up menu: Displays the zone name. Click to choose other zones.
File pop-up menu: Displays the audio filename. Click to choose file handling commands.
Load Audio File: Opens a dialog where you can select an audio file.
Rename Current File: Opens a dialog where you can rename the selected audio file.
Detach Current File: Detach the selected audio file from the zone. You can load and assign another audio file to this zone.
Show in Finder: Shows the full path of the loaded audio file in the Finder.
Playback buttons: Use these options to determine zone playback behavior.
One Shot button: Turn on to make the zone ignore the length of incoming MIDI note events, resulting in the sample always being played from start to end whenever a note-on event is received. This is useful for drum samples, where you often don’t want the MIDI note length to affect sample playback. Also see the Fade field parameters.
Loop and crossfade parameters are dimmed when the One Shot button is active.
Reverse button: Turn on to play the sample from the sample end marker to the sample start marker.
Flex On/Off button: Turn Flex mode on or off. If Flex mode is turned on, an audio sample is played at its original speed for all note pitches. See the task in this section to learn more about Flex use.
Follow Tempo button: When Flex mode is active, turn on to follow the project tempo.
(Flex) Speed pop-up menu: When Flex mode is active, choose a playback speed division or multiplication value.
Tip: Flex Speed is also available as a modulation target.
Sample Start/End handles and fields: Set the sample start and end points. Drag to reposition. Option-click, then drag either handle to move both markers.
Sample Length field: Displays the length between the sample start and end marker positions. Drag vertically to move the end and fade-out marker.
Fade In/Fade Out handles and fields: Set the fade-in or fade-out time for the zone. Drag to reposition. Option-click, then drag either handle to move both markers. The fade markers cannot be positioned before or after the sample start and end markers.
Loop Start/Loop End handles and fields: Set the loop start and end points. Drag to reposition. Drag the shaded loop area to move both markers and the crossfade marker. Alternatively, you can Option-click, then drag either handle to move both markers and the crossfade marker.
Loop Length field: Displays the length between the loop start and end marker positions. Drag vertically to move the loop end and crossfade marker.
Loop Mode pop-up menu: Choose a looping mode. Set to No Loop to disable looping.
No Loop: Turn off looped playback. This hides loop markers and crossfades from the waveform display.
Forward: Playback cycles from the loop start point to the loop end point while you hold a key.
Reverse: Playback cycles from the loop end point to the loop start point while you hold a key.
Alternate: Playback continuously cycles from the loop start point to the loop end point, then switches from the loop end point to the loop start point, while you hold a key.
Play to End on Release: Turn on to continue playback to the end marker position after you have released the key—provided that the amp release time is long enough for the audio portion after the loop to be audible. This feature is useful for allowing the natural decay of a sampled acoustic instrument to be heard during the envelope release phase, for example.
Crossfade handle and field: Drag to set the crossfade time between the end and start of a looped sample. The crossfade marker handle is indicated with an X in the waveform display. Option-click, then drag the handle to move both crossfades.
In a crossfaded loop, there is no step between the loop end and loop start points. The higher the value, the longer the crossfade and the smoother the transition between the loop end and start points. This is especially convenient with samples that are hard to loop and that would normally produce clicks at the transition point—the join in the loop.
Use Sampler Zone pane start, end, loop, fade, anchor, and crossfade markers
You can use Sampler Zone pane markers to alter audio playback in MainStage. To define the possible positions for markers, use the Snap menu.
Do any of the following:
Drag the blue start or end marker to set the sample start and end point. Playback occurs between these markers.
Press and hold Option, then drag either the start or end marker to move both the sample start and end point.
Drag the gray fade in or fade out marker to change the length of the fade at the beginning and end of the audio file segment between the start and end markers.
Press and hold Option, then drag either the fade in or fade out marker to move both fade markers.
Drag the yellow loop start or end marker to set loop boundaries. Playback cycles between these markers when you hold a note.
Drag the yellow shaded area between the loop start and end markers to move the entire loop. Alternatively, press and hold Option, then drag either the loop start or end marker to move the entire loop
Drag the gray crossfade marker (indicated with X) to set the length of the crossfade at the beginning and end of loop boundaries, smoothing out audible glitches as the loop cycles across the loop end and start points.
Drag the light blue anchor marker to set the absolute start point of the audio file.
Note: The anchor marker is visible only when Show Anchor is selected in the Zone pane View menu.
Quickly zoom a portion of the Zone pane waveform display
In MainStage Sampler, the zoom buttons and pinch gestures can be used to zoom the waveform display shown in the Zone pane, but you can also do the following to quickly zoom a portion of the waveform:
Press and hold Control and Option, then drag in the waveform display.
The selected area is zoomed to fill the entire waveform display.
Tip: Double-click the Zone button in the Navigation bar to quickly switch between a maximized view of the Zone pane and the current view.
Use the Sampler Zone pane shortcut menu
In MainStage, you can use the shortcut menu to choose a number of sample-handling commands. Control-click in the waveform display to access available options from the shortcut menu.
Important: The shortcut menu is context-sensitive. The commands shown in the Zone pane shortcut menu change when you click on different portions of the waveform display. For example, you will see different Auto-Loop commands when you Control-click directly on the yellow shaded loop area in the waveform display.
Auto-Loop: Analyzes the audio content and automatically sets a loop. You can use the command multiple times to try different automatic loops.
Auto-Loop within loop area: Analyzes the audio content and automatically sets a loop within the area defined by the loop start and end markers. You can use the command multiple times to try shorter automatic loops.
Retune: Analyzes the audio content and sets the root key and tuning value automatically.
Crop Sample: Crops (cuts) the portion(s) of the sample outside the start and end markers.
Crop Loop: Crops (cuts) the portion(s) of the sample outside the loop start and end markers.
Note: The “Crop” commands don’t modify or cut existing files. New files are created and are used in place of the original files.
Write Sample Loop to Audio File: Saves the loop data to the file header of the audio file.
Linear or Equal Power Crossfade: Set crossfade gain behavior. Linear scales amplitude for the crossfade. Equal Power boosts the middle of the crossfade range and fades out/in at an equal volume level.
Use the Sampler Zone pane Edit menu
In MainStage, you can use the Zone pane Edit menu to choose a number of sample-handling commands. Choose any of the following:
New: Create a new, empty zone. You can add audio to this zone from the File menu or with a drag and drop operation.
Auto-Loop: Analyzes the audio content and automatically sets a loop. You can use the command multiple times to try different automatic loops.
Auto-Loop within loop area: Analyzes the audio content and automatically sets a loop within the area defined by the loop start and end markers. You can use the command multiple times to try shorter automatic loops.
Retune: Analyzes the audio content and sets the root key and tuning value automatically.
Re-Analyze Transients and Tempo: Re-analyzes the current audio for transient and tempo changes, following edits you have made. This corrects transient or tempo changes caused by incorrect tempo data written in the file header, unexpected results from Flex use, or other tempo and transient manipulations, for example.
Derive Tempo from Loop Length: Calculates a tempo for the audio file based on the Loop Length. If using the Follow Tempo button does not yield the desired results, you can choose this option to calculate a revised tempo at which the loop is aligned to the beat.
Crop Sample: Crops (cuts) the portion(s) of the sample outside the start and end markers.
Crop Loop: Crops (cuts) the portion(s) of the sample outside the loop start and end markers.
Optimize Loop Start: Use to automatically adjust the loop start point to create a smooth loop cycle.
Optimize Loop Crossfade/End: Use to automatically set crossfade values at the point in the loop cycle where the loop end and loop start markers cross over. Loop length is not affected.
Write Sample Loop to Audio File: Saves the loop data to the file header of the audio file. To save the new audio file with a different name, click the Name field and choose the Rename Current Audio command.
Optimize Sample Gain: Analyzes the audio content and sets automatic gain values.
Linear or Equal Power Crossfade: Set crossfade gain behavior. Linear scales amplitude for the crossfade. Equal Power boosts the middle of the crossfade range and fades out/in at an equal volume level.
Use the Sampler Zone pane View menu
In MainStage, you can use the Zone pane View menu to choose a command that changes the appearance of the Zone pane. Choose any of the following:
Display Seconds/Sample/Beats Units: Shows time, sample, or bar/beat values in the waveform display.
Display Stereo Channels/Mono Sum: Shows a stereo or summed mono waveform view in the waveform display.
Show Anchor: Shows the absolute start point of the audio file in the waveform display. This can be useful for noises that precede instrument sounds such as the intake of breath of a horn player or tambourine shakes, as examples.