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 screen controls to display PDF document pages in MainStage
You can import a multipage PDF document into your layout and then use screen controls to select a page or turn the pages. This is useful if, for example, you want to add a PDF of sheet music or lyrics to your layout and then advance the pages as you perform. In MainStage, you import the PDF into a Background screen control.
Add multi-page PDF documents
In order to map screen controls to turn the pages of a multipage PDF, your layout must contain at least one Background screen control with a multipage PDF selected as the image, and one Patch List screen control to act as a table of contents for your PDF. If your layout does not already contain these items, follow the steps below:
In MainStage, click the Layout button at the upper-left corner of the MainStage window (or press Command-1).
Drag one of the Patch List screen controls from the Screen Controls palette to the workspace.
In the Patch List screen control, click the list.
In the Screen Control Inspector for the Patch List screen control, select the Patch Names or Markers checkbox.
Drag a Background screen control from the Screen Controls palette to the workspace.
In the Screen Control Inspector for the Background screen control, click the Image button.
Drag your multipage PDF into the image well, or click the Select button, browse to the location of the PDF, and select it.
If you have multiple PDFs—for example, to add both a PDF of sheet music and a PDF of lyrics—repeat the steps above to add both a Patch List and Background screen control to your layout for each PDF.
Map screen controls to turn pages of a multi-page PDF
With a multipage PDF as a Background image and a dedicated Patch List screen control for that PDF, you can then map the Next Patch and Previous Patch buttons at the bottom of the Patch List to navigate from one page to the next.
In MainStage, click the Edit button at the upper-left corner of the MainStage window (or press Command-2).
Select the Patch List screen control you wish to assign to the multipage PDF.
In the Attributes tab of the Screen Control Inspector, choose Image/PDF Object 1.
All the page numbers in your multipage PDF appear in the Patch List.
Click the Next Patch button at the bottom of the Patch List screen control.
In the Attributes tab of the Screen Control Inspector, select Override Concert Mapping.
In the Unmapped tab of the Screen Control Inspector, choose Actions > Image/PDF Objects > Image/PDF Object 1.
The name of the parameter tab changes to PDF Page.
In the Range Mode pop-up menu, choose Increase Value.
Repeat steps 5 and 6 for the Previous Patch button at the bottom of the Patch List screen control.
In the Range Mode pop-up menu, choose Decrease Value.
You can now click the Next Patch and Previous Patch buttons to move forward or backward one page at a time in your multipage PDF.
If you have multiple PDFs, follow the steps above for each Patch List screen control associated with each additional PDF, incrementing the numbering—so if you have two PDFs, in your second Patch List screen control in step 3 you would choose Image/PDF object 2, and so on.
You are not limited to only turning pages using the Next Patch and Previous Patch buttons below the Patch List screen control. Using the Assignments & Mappings tab, you can assign any assignable screen control to increase and decrease value. For example, if you wanted larger screen buttons to turn pages, you could use Drum Pad screen controls. Or if you wanted to turn pages using your MIDI keyboard, you could assign one key on your MIDI keyboard to increase and another key to decrease page numbers. See Overview of assignments and mappings in MainStage and Map MainStage screen controls to actions for comprehensive instructions on how to assign screen controls to parameters.
Map screen controls to select a page of a multipage PDF
With a multipage PDF as a Background image and a dedicated Patch List screen control for that PDF, you can then map any screen control to select a page of the PDF by changing the patch number in the Patch List.
In MainStage, if you haven’t already associated a Patch List screen control with the multipage PDF you want to use, follow steps 1 through 3 in the previous task.
Select the screen control you want to select a page in your PDF.
In the Unmapped tab of the Screen Control Inspector, choose Actions > Image/PDF Objects > Image/PDF Object 1.
If you have multiple PDFs in your layout, use the PDF Object number for the PDF with the page you wish to select.
The name of the parameter tab changes to PDF Page.
In the Range Mode pop-up menu, choose Standard.
In the Button On and Button Off pop-up menus, choose the number of the page you wish to select.
Triggering the screen control now selects the specific numbered page in your PDF you chose in step 5.
You can assign multiple screen controls to select individual page numbers in the same PDF. You can also assign multiple screen controls to select individual page numbers in separate PDFs. Using the Assignments & Mappings tab, you can assign any screen control capable of being assigned to select a patch number to select a page in a multipage PDF. See Overview of assignments and mappings in MainStage and Map MainStage screen controls to actions for comprehensive instructions on how to assign screen controls to parameters.