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
Manage MainStage content
MainStage features an extensive Sound Library of Apple Loops, patches, drum kits, and other content that you can use in your projects. When you install MainStage, essential sounds and instruments are included as part of the installation. Additional content is available to download after the installation is complete.
You can view available content and select content to download in the Sound Library Manager. Some items in the Sound Library Manager have a disclosure arrow, which you can click to show and select individual content types to download. You can also download updated sounds and reinstall the complete Sound Library using the Sound Library Manager. Updated sounds are indicated in the Sound Library Manager and can be downloaded.
Additionally, in the Patch Library, items requiring additional content are indicated by an icon . You can download the content needed for the item by clicking its icon.
Additional content is required to use some sounds and other features. When you select an item that needs additional content, a dialog appears, asking if you want to download it. In the Drum Kit Designer plug-in, drum kits not yet installed include a Download button that opens the Additional Content window.
Content types
The Sound Library includes the following types of content:
Apple Loops
Drum kits
Patches
Plug-in settings
Sampler instruments and their associated samples
Impulse responses
Legacy and compatibility content, including Jam Packs, sounds, and instruments
Content locations
MainStage installs Sound Library content in several different locations on your computer:
Content type | Location | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Apple Loops | /Library/Audio/Apple Loops/Apple/ | ||||||||||
Impulse responses | /Library/Audio/Impulse Responses/Apple/ | ||||||||||
Patches | Patches are stored inside MainStage. They may be added, updated, or removed when a new version is installed. | ||||||||||
Plug-in settings | Plug-in settings are stored inside MainStage and in /Library/Application Support/Logic/Plug-In Settings. | ||||||||||
Sampler instruments | /Library/Application Support/Logic/Sampler Instruments | ||||||||||
Samples |
|
Relocating the Sound Library
You can relocate the Sound Library to another compatible volume or partition, provided enough free space exists for the Sound Library. When you relocate the Sound Library, all Sound Library content except for Apple Loops and Impulse Responses are moved to the new location. User-created content is not affected.
Relocating the Sound Library to an external drive can free up a large amount of disk space on your system drive. If you change your mind or decide you no longer want to keep the content in another location, you can relocate the Sound Library back to its original location. When you install additional content after relocation, it is installed in the new location. For detailed information on relocating content and possible issues, see the Support article Move Logic Pro and MainStage content on the Web.
Note: Other Apple music creation apps such as Logic Pro and GarageBand share the same Sound Library location. When you relocate the Sound Library, it is also relocated for these apps if they are installed on your computer.
Reinstalling the Sound Library
You can reinstall the Sound Library. This can be useful to make sure you have the latest version of all available content, and also in case the drive containing the Sound Library is no longer available.
If the Sound Library is available in its current location when you reinstall it, it is reinstalled in the same location. If the Sound Library is not available (for example, if it is installed on an external drive that is lost, or not connected to your computer), it is reinstalled in the default location on your system drive.
Deleting MainStage content
You can view and delete MainStage content by choosing About This Mac from the Apple menu, clicking Storage, then clicking the Manage button for your system storage drive. Content for MainStage (as well as other music creation applications, including Logic Pro and GarageBand) is listed in the Music Creation section. You can view the capacity of the Instrument Library and Apple Loops library and delete each of these items.
If you delete MainStage content that is required for a patch or software instrument, MainStage prompts you to re-download that content the next time you try to use the patch or instrument.
Open the Sound Library Manager
Choose MainStage > Sound Library > Open Sound Library Manager.
Select and download additional content
In MainStage, do one of the following:
In the Additional Content window, select the checkbox for each content package you want to download.
To download all installed content, click the Select All Uninstalled button.
Click Install.
Download all available sounds
Choose MainStage > Sound Library > Download All Available Sounds.
Relocate the Sound Library
Choose MainStage > Sound Library > Relocate Sound Library.
The Relocate Sound Library window opens, showing available drives and the free space available on each. Unsuitable drives are greyed out, with the reason for their unsuitability shown in the Comments column.
Select the new Sound Library location, then click Relocate.
The Sound Library is relocated to the selected location. If other music creation apps such as Logic Pro or GarageBand are open, you are asked to close them before relocation can proceed.
When relocation is complete, the Relocate Sound Library window closes.
Reinstall the Sound Library
Choose MainStage > Sound Library > Reinstall Sound Library.
While additional content is downloading, a progress bar appears in the right side of the toolbar. You can view more detailed information about the progress of the download by clicking the progress bar.