Onstage live keys rig logo
QUICK START GUIDE

Onstage Quick Start Guide

Welcome to the Quick Start Guide for Onstage, the software live keys rig for Windows PCs and Android mobile tablets. Learn how to install the app, configure setlists, stack sounds, and map your hardware MIDI keyboard.

Installation & Setup

Installation, system requirements, and first-launch setup.

What is Onstage?

Onstage is a standalone live keys rig for Windows and Android. Unlike Ableton or MainStage, it is not a general-purpose DAW but a dedicated live keys rig, purpose-built to stay lightweight and reliable on stage. It requires no third-party plugin hosting; you simply install the lightweight application, download the sound pack, and connect your USB/Bluetooth MIDI keyboard.

Not sure what gear or cables you need?

Use the Setup Builder: answer a few questions about your keyboard and device, and we'll list the exact setup and materials for you.

Open Setup Builder →

System Requirements & Compatibility

  • Windows: Windows 10 or Windows 11 (x64), including native support for Windows on ARM devices (Surface Pro and other ARM PCs). Direct installation.
  • Android: Android 10 or higher. Touch screen interface on phone or tablet.
  • MIDI Keyboard: Compatible with standard USB MIDI keyboards and controllers, plus Bluetooth MIDI (BLE MIDI) controllers on Android.

Bypassing Security Warnings

Unsigned Direct Download

Windows installs directly and Android installs from Google Play. Direct Windows and APK installs may show standard security prompts:

Windows 10 / 11

SmartScreen Warning
.EXE
1
Open onstage-win-x64-installer.exe.
2
Click More info on the SmartScreen prompt.
3
Click Run anyway.

Android 10+ (APK)

Direct install · Unknown Sources / Play Protect
.APK
1
Open wavefire.onstage.apk → tap Settings.
2
Enable Allow from this source.
3
If Play Protect prompts, tap More details → Install anyway.

First Launch & Sound Pack Prompt

On first launching Onstage, the application automatically opens the Download Packs page so you can install the Onstage Basics Pack. Once installed, you will immediately have access to core piano, pad, and synth sounds to begin building patches.

Appearance & Accent Color

Open Settings → Appearance → Accent Color to choose from 14 accent colors, including cyan, silver, cobalt, teal, jade, lime, green, amber, orange, red, rose, orchid, amethyst, and indigo. The selected accent is applied throughout the interface and remembered between launches.

Setlists & Patches

Organize songs and manage multi-layer live rigs.

Finding Setlists and Patches in Onstage

From the Start Page → tap New Setlist or Open Setlist, or select any setlist under Recent Setlists.

Understanding Setlists vs. Patches

Think of a Setlist as your concert song order, and a Patch as the complete sound rig for a single song. When you tap a patch, all 16 sounds, splits, transpositions, and ambient pads switch instantly without cutting off held notes.

Setlists

A Setlist represents your live show or service order. It contains the ordered list of sound patches you will switch between during a performance.

  • Create a setlist from the Start Page (New Setlist) or browse, search, rename, edit, import, and delete setlists from the Setlist Library (Open Setlist).
  • The 2 most recent setlists appear under Recent Setlists on the Start Page for 1-tap recall.
  • Demo mode supports 1 active setlist with up to 2 patches per setlist. A License Key unlocks unlimited setlists and patches.

Reordering Patches

Patch order is the order you perform in. To change it, open the setlist and toggle Sort mode (the up/down arrow button next to Add), then drag a patch by its drag handle to its new position. The new order is saved automatically and is kept the next time you open the setlist.

Patch Architecture

Each patch is an isolated multi-layer keyboard rig containing sound layers, scene volume snapshots, transpose settings, and per-patch Ambient Pad settings. Each patch also carries its own tempo and time signature; tempo changes apply instantly to the active patch.

Play-In vs. Hear-In Transposition

Onstage supports semitone transposition configured per patch. Set your Play-In key (the physical key you play on the keyboard) and Hear-In key (the key the rig sounds in). Transposition transitions instantly and smoothly without any stuck notes or cutting off your sound.

Onstage Patch Library & Setlist View

Importing Setlists & Patches

Bring shared setlists and individual patches from other devices into your library.

Finding Import in Onstage

Setlists are imported from the Start Page → Open Setlist → Import. Patches are imported while a setlist is already open: tap Add → From Library → Import, then select a .onpatch file.

Onstage lets you bring in setlists and patches created or exported from another device (for example, a patch shared by a teammate). Importing a setlist restores it together with the patches it contains, while importing a patch adds a single patch to the setlist you currently have open.

Importing a Setlist

  1. From the Start Page, tap Open Setlist to open the Setlist Library.
  2. Tap Import.
  3. Select the setlist file you want to bring in. The imported setlist (and its patches) appears in your library, ready to open like any other setlist.

Importing a Patch

  1. Open the setlist you want to add the patch to.
  2. Tap Add, then choose From Library.
  3. Tap Import and select the .onpatch file.
  4. The patch is added to your current setlist and can be edited or reordered like any other patch.

Sharing Setlists & Patches

To move content between devices, export a setlist or patch from the source device and import it on the destination.

⚠️ Sounds & SoundFonts Are Not Included: Shared setlists and .onpatch files do not include any user SoundFonts (.sf2) or sound samples. The person importing must already have the required content pack and sounds installed in Onstage or the patches will not sound as intended. To share everything together (setlist, patches, and the sounds they use), use the Pack Creator to export a Content Pack (.onpack) instead.

ℹ️ Activation Requirement: Importing and exporting setlists and patches is a full-version feature. If the app is running in Demo Mode, tapping Import will open the License Activation prompt.

Sound Layer Editing

Stack up to 16 sound layers with splits, velocity, and expression.

What is a Sound Layer?

A Sound Layer is an individual instrument (such as an Acoustic Piano, Warm Pad, Organ, or Brass synth). By stacking multiple layers together, you can create massive blended textures or divide your keyboard into split zones (e.g., bass on the left hand, piano/pad on the right hand).

Every patch can stack up to 16 sound layers simultaneously (3 in Demo mode). Each layer features an extensive sound editor split into four categories. When you audition a sound in the Sound Library, it previews over the current patch layers so you hear how it blends before you commit it.

1. Keyboard & Velocity

  • Key Range: Range sliders (21–108)
  • Velocity Range: Circular min/max sliders
  • Fixed Velocity: Fixed velocity toggle
  • MIDI Device & Channel: Isolation filters
  • Filter MIDI CC: Only allow essential controllers (mod wheel & sustain)

2. Pitch & Expression

  • Octave Shift & Transpose: Octave shift (-3 to +3), octave layer, & semitone transpose (-12 to +12)
  • Ignore CC: Ignore Sustain, Mod Wheel, Pitch Bend
  • Mod Wheel Target: Default Vibrato, LowPass Sweep, Volume Swell
  • Glide / Portamento: Always, Legato, Staccato modes & Time, Time Mode, Retrigger

3. Audio Effects

PRO
  • Gain: Per-layer output gain
  • 3-Band Equalizer: Low & High shelving, Mid (gain, freq, Q)
  • ADSR Envelope: Attack, Decay, Sustain, Release
  • Reverb: Room presets, Size, Damp, Width, Level
  • Chorus: Presets, Voices, Speed, Depth
  • Stereo Delay: Echo, Ping-Pong, Slapback, Ambient Dub

4. MIDI Patterns

PRO
  • Chord Trigger: Bind a root note to multi-note chord grids
  • Arpeggiator: Pattern, Subdivision, Steps & velocity grid
  • Step Sequencer: Up to 16 steps with note & gate/rest
  • Direct Keypress Sync: Runs from keypress timestamps
Keyboard & Velocity Settings Keyboard & Velocity Settings UI
Pitch & Expression Settings Pitch & Expression Settings UI

Basic Sound Design Workflow

Configuring Key Range & Splits

Under Keyboard & Velocity → adjust the Key Range slider on the piano roll interface to set split zones (e.g. Bass on C1–B2, Piano on C3–C6). Toggle Fixed Velocity for organ layers that don't use key dynamics.

Pitch, Expression & Mod Wheel Target

Under Pitch & Expression → toggle Ignore Sustain Pedal to prevent bass notes from sustaining. Set Mod Wheel Target to LowPass Sweep or Volume Swell for real-time filter sweeps using your hardware modulation wheel (CC 1).

Playing Without a Controller

The performance view includes a playable piano roll with on-screen Pitch Bend and Mod Wheel strips. Drag the pitch bend strip for real-time bends, raise the mod wheel to drive each layer's selected mod wheel target, and tap the piano roll keys to play. These controls feed the same MIDI path as an external controller, so they work with every patch.

Dynamic Scenes

Volume snapshots for song sections with smooth crossfades.

Why Use Scenes?

In live music, different sections of a song require different dynamics (e.g., quiet piano in Verse 1, huge piano + pad stack in the Chorus). Scenes let you switch layer volume levels instantly or over a smooth crossfade without changing patches.

Scenes capture layer-volume snapshots per patch (e.g. Intro, Verse, Chorus, Bridge). Switching scenes crossfades every layer's volume smoothly over a configurable transition duration (seconds).

  • Create up to 5 scenes per patch (3 in Demo mode).
  • Set individual crossfade durations (e.g., 2.0s for smooth pad sweeps, 0s for instant changes).
  • Capture the current layer volumes and mod wheel position into the active scene using the Save button in the scene switcher. Switching back to the scene restores both, so the brightness or expression you set is recalled with the mix.
  • Trigger scenes using touch targets, footswitches, or MIDI-learned buttons.
Dynamic Scenes & Live Performance View

Ambient Pad Player

Instant one-key worship and ambient pad engine.

Finding Ambient Pad Player in Onstage

Open any setlist patch → look at the bottom of the left sidebar → tap the AudioWaveform icon (looks like vertical audio wave lines) to open the Ambient Pad Player page.

What is the Ambient Pad Player?

The Pad Player produces continuous ambient background drone pads in any key (C, D, G...). It operates independently of your keyboard layers, allowing you to fill empty space during song transitions, speak over pads, or play ambient worship without taking up key zones.

The built-in Ambient Pad Player provides instant background pads and drone chords during setlists without occupying keyboard split zones.

  • Key Selector: On larger screens, the pad page shows a chromatic Key Selector card for switching keys quickly; small screens use the full-page pad player instead. On larger screens the full-page pad player is still available for every pad parameter. Tap a root key (C, C#, D ... B) to crossfade the pad engine to the selected key.
  • Engine Controls: Adjust Master Volume and Fade (transition time), plus Voicing Style, Chord Type, Inversion, and Mod Wheel routing.
  • Chord Types & Voicings: Major, Minor, Sus2, Sus4, Maj7, Min7, or Dom7 with Standard, Wide (Drop 2), Deep (Sub Bass), or High Octave voicings and inversions.
  • Mod Wheel Routing: Route CC1 (Modulation Wheel) to a Lowpass filter sweep for real-time pad brightness control.
  • Pad Layers: Stack multiple pad sounds with individual volumes (1 layer in Demo mode).
  • Save Key to Patch: Store the active key, chord, and voicing settings per patch so changing patches recalls the pad engine automatically.
Ambient Pad Player UI

MIDI Learn & Fader Pickup

Hardware controller knob, fader, and button mapping.

Finding MIDI Devices Setup in Onstage

Tap the KeyboardMusic icon (looks like a musical keyboard with notes) in the top-right corner of the Start Page, or in the left sidebar of any open setlist (directly above the MIDI Learn icon). All connected controllers are enabled by default. Assign each one a Routing Role (keys, control surface, or disabled) so knobs and faders never trigger synth notes. On Android, Bluetooth MIDI (BLE MIDI) controllers are supported and appear here too.

Finding MIDI Learn in Onstage

Open any setlist patch → look at the left sidebar → tap the Waypoints icon (four connected dots directly below the MIDI Devices KeyboardMusic icon).

Understanding MIDI Learn & Smart Fader Pickup

MIDI Learn lets you tap any control on screen and move a physical knob or slider on your keyboard to link them together. Smart Fader Pickup prevents sudden volume jumps when switching songs: your physical fader will not alter volume until it passes through the current saved setting.

Bind any hardware MIDI controller knob, fader, pad, or footswitch directly to Onstage performance controls. The MIDI Learn page groups the supported learnable targets into the following sections:

Patch Layers

16 volume slots (Layer 1–16) for controlling the volume of each sound layer in the active patch.

Scenes

5 scene trigger slots (Scene 1–5) to fire scenes directly from a pad or footswitch.

Scene Navigation

Next Scene and Previous Scene for stepping through scenes in order.

Patch Switcher

Next Patch and Previous Patch for moving up and down the setlist without touching the screen.

Master Volume

A single Master Volume slot controlling the overall output level.

Pad Player

Pad Volume and Pad On/Off for the Ambient Pad Player engine.

Tempo Controls

Tap Tempo, Increase, and Decrease for live tempo control of arpeggiators and sequencers.

  • Device & Channel Aware: Bindings lock to specific controller names so plugging in multiple devices works seamlessly.
  • Smart Fader Pickup: Prevents volume jumps when changing scenes or patches. The physical fader movement is ignored until it passes through the current volume level.
  • Learnable Inputs: The Learn button responds to CC knobs/faders, the mod wheel (CC 1), the sustain pedal (CC 64), and note-on pads or buttons.
  • Keyboard Triggers & Hotkeys: Switch and trigger controls can also learn a keyboard key or a modifier + key hotkey. Assign scenes, patch changes, pad on/off, or tempo controls to a computer keyboard so you can perform without a control surface.
MIDI Learn Controller Mapping UI

Studio Audio Effects Suite

Studio quality per-layer audio processing (License Key feature).

What is the Studio Audio Effects Suite?

Studio audio effects allow you to polish raw instrument sounds directly inside Onstage. Use EQ to shape warmth or brightness, Reverb to create room space, Delay for rhythmic echoes, and Chorus for stereo width without requiring external hardware effect units.

Gain

Per-layer output gain for balancing stacked sounds.

3-Band Equalizer

Low shelf, parametric mid (gain, frequency, Q), and high shelf per layer.

ADSR Envelope

Attack, Decay, Sustain, and Release shaping per layer.

Reverb

Small Room, Medium Hall, Large Hall, and Cathedral presets with Room Size, Damp, Width, and Level.

Chorus

Light, Medium, Heavy, and Flanger presets with Voices, Level, Speed, and Depth.

Stereo Delay

Echo, Ping-Pong, Slapback, and Ambient Dub presets with Time, Feedback, and Mix controls.

Audio Effects Suite UI

MIDI Patterns

Rhythmic arpeggiators, chord triggers, and step sequencers.

What are MIDI Patterns?

MIDI Patterns alter your note input in real time. Arpeggiators turn held keys into rhythmic note sequences, Chord Triggers let a single key press fire complex multi-note chords, and Step Sequencers play custom rhythmic patterns.

  • Arpeggiator: Pattern presets (Up, Down, Up / Down, Random, Chord), Subdivision, Steps, and 16-step Velocity Pattern grid.
  • Chord Triggers: Map Root Note to custom multi-note chord grids with clear/learn note capabilities.
  • Step Sequencer: Program sequence patterns up to 16 steps with note, velocity, and gate/rest tracking.
  • Direct Keypress Sync: Runs directly from keypress timestamps without needing DAW clock sync.
MIDI Patterns & Processors UI

Advanced Sound Design & Pattern Building

Arpeggiator & Velocity Pattern

Under MIDI Patterns → enable Arpeggiator. Select Pattern (Up, Down, Up / Down, Random, Chord), set Subdivision & Steps, and adjust the 16-step Velocity Pattern grid for rhythmic accents.

Chord Triggers & Root Notes

Under Chord Triggers → bind a single Root Note key to trigger a full chord grid of learned notes. Use right-click or long-press context flyout to Clear Root Note or Clear Note anytime.

Glide / Portamento Setup

Under Pitch & Expression → enable Glide / Portamento. Configure Glide Mode (Always, Legato, Staccato), adjust the Time Dial, and set Time Mode (Linear, Standard, Auto) for synth lead slides.

Audio Settings, Latency & Crackle Troubleshooting

Current controls and practical adjustments for Android and Windows output.

Where to find the controls

Open Settings from the Start Page, then use Global Settings. Audio controls are under Audio Engine & Output; voice and memory controls are under Synthesizer & Voice Performance. Press Save to apply. Audio changes are applied in the running app; driver and device changes reopen the audio engine in-process.

Choose an output path

Android Driver

Uses Android's standard audio output. Select a preferred Audio Output Device when available; Android may override that preference. The engine sample rate, audio buffer, periods, Exclusive Audio Access, and Low Latency Mode controls are available on this path.

Studio Driver (Android USB)

Sends audio directly to a selected USB Audio Class device. Choose the USB DAC, its sample rate, and USB buffer size. This path has its own controls; Android Driver periods and Low Latency Mode do not configure the Studio USB stream. If a device fails or crackles, try a larger USB buffer or switch to Android Driver.

The Output Driver selector is available on Android. Windows uses its native output path and the Windows audio controls shown in Global Settings.

Available audio controls

Sample Rate — Android Driver / Windows

Auto (Native), 22050, 44100, 48000, 96000, or 192000 Hz. Auto follows the native device rate and usually avoids unnecessary resampling. Use a rate supported by the selected output device. The Auto (Native) selection is kept after visiting Settings.

Audio Buffer Size — Android Driver / Windows

Android offers Native plus 256, 512, 1024, 1280, 1536, 1792, and 2048 frames. Windows offers 256, 512, 1024, 1280, 1536, 1792, and 2048 frames. Smaller buffers reduce buffering delay but leave less time to render each block; increase the size if you hear crackles or dropouts.

Audio Periods — Android Driver / Windows

Choose 1, 2, 3, or 4 periods. Fewer periods can reduce buffering; more periods can improve stability on devices that underrun. This control is separate from the Studio Driver USB buffer.

Exclusive Audio Access

Requests direct/exclusive access to the output where supported, which can reduce system mixing and latency. Other apps may not be able to use that output at the same time. Turn it off if the device cannot open in exclusive mode.

Low Latency Mode

Requests the platform's low-latency performance path. It may improve response, but can expose underruns on some devices; turn it off if crackling continues after increasing the buffer.

Studio USB Sample Rate & Buffer

USB Sample Rate offers Automatic, 44100 Hz, and 48000 Hz. Automatic prefers 48 kHz, then 44.1 kHz, then the lowest rate advertised by the device. USB Buffer Size offers 256, 512, 768, 1024, 1536, or 2048 frames; the default is 1024. Lower values reduce USB buffering, while higher values add scheduling headroom.

Max Polyphony

Sets the maximum simultaneous synth voices from 32 to 256 in steps of 8. Lower it if dense patches or chords overload the device.

Load Samples on Demand & Show Performance Metrics

Load Samples on Demand reduces memory use by loading samples as needed; on slower storage it may increase first-note loading work. Show Performance Metrics displays CPU and memory indicators in Performance View; the level and CPU meters stay accurate at any buffer size. Multi-Core is retired and is not an available setting.

Troubleshooting latency and crackles

Reduce key-to-sound delay

  1. On Android with a compatible wired USB interface, try Studio Driver.
  2. Start with Auto (Native) sample rate and a 256- or 512-frame buffer.
  3. On Android Driver / Windows, try a smaller supported buffer and 1–2 periods.
  4. Enable Exclusive Audio Access and Low Latency Mode where available.
  5. If only the first note is delayed, try turning off Load Samples on Demand.

Fix crackles or dropouts

  1. Increase the active output path's buffer one step (for example, 256 to 512).
  2. For Android Driver / Windows, try 3–4 periods.
  3. For Studio Driver, raise USB Buffer Size (768 or 1024 frames are reasonable starting points).
  4. Turn off Low Latency Mode or Exclusive Audio Access if the device is unstable.
  5. Reduce Max Polyphony if crackles happen during dense playing; check Performance Metrics.

Check the selected route

  1. Confirm Onstage is routed to the intended output device.
  2. For Studio Driver, select the connected USB DAC and reconnect it if it is absent.
  3. Use a sample rate supported by the device, or select Automatic.
  4. Save settings and allow the in-app audio engine update to finish.
  5. Export Application Logs from Diagnostics & System Logs if the problem persists.

Latency and stability depend on the device, driver, output route, and workload. Change one setting at a time and test with the same patch and playing style.

Content Packs & Pack Creator

Downloading official sound packs, finding included presets, and building custom content packs.

Finding Content Packs in Onstage

From the Start Page → tap the Content Packs button (Package icon) to open the Content Library, or tap Pack Creator (PackagePlus icon, visible only in the full version) to export custom packages.

What are Content Packs?

Content Packs (.onpack) are self-contained bundles of sound samples, SoundFonts (.sf2), and preset setlist patches. Onstage includes built-in tools for downloading official sound packs as well as creating your own custom packs to share with team members.

Where to Find Packs & Included Presets in Onstage

1. Downloading Official Packs

On the Start Page tap Content Packs to open the Content Library, then tap Download (also offered automatically on first launch and after license key activation). Download Onstage Basics (Free/Demo starter sounds) or Onstage Essentials (Full license pack with 33 sounds & 10 curated preset patches).

2. Finding Presets & Installed Sounds

Sounds can be found in the Sound Library when adding a new sound layer or changing a layer's sound in a patch. Preset patches can be found when adding a new patch to a setlist tap Add, then select from Library.

Creating & Exporting Custom Content Packs

Onstage includes a built-in Pack Creator UI allowing musicians and worship leaders to package custom setlists, sound layers, and SoundFont (.sf2) samples into portable .onpack files.

Step 1: Open Pack Creator

From the Start Page tap Pack Creator (PackagePlus icon, visible in the full version). Tap Choose to pick the setlist you want to export.

Step 2: Set Pack Metadata

Under Pack Details: enter Pack Name and Author (the Pack Identifier is generated automatically), and toggle Requires Full Version if the pack uses full-version sounds or DSP effects.

Step 3: Review & Export

Under Sounds: verify included sound layers and sample files. Click Export Pack to generate a portable .onpack file.

SoundFont (.sf2) Import Guide

Optimizing and importing custom SoundFont files for live performance.

Finding SoundFont Import in Onstage

Open any setlist patch → tap Add Sound or Replace Sound on any layer to open the Sound Library page → look in the top right corner → tap the Import Sound button.

Onstage allows you to import custom SoundFont (.sf2) files directly into your Sound Library. The Sound Library page opens automatically whenever you add a new sound or replace an existing sound layer inside a patch.

ℹ️ Activation Requirement: Importing custom SoundFonts is a premium feature. If the app is currently running in Demo Mode, attempting to click the Import Sound button will open the License Activation prompt.

Single-Preset Requirement & Polyphone Guide

For optimal memory usage and low audio latency on stage, Onstage requires single-preset SoundFont (.sf2) files. If you have multi-preset SoundFont banks, open them in free tools like Polyphone, right-click the desired preset, export it as a single .sf2 file, and import it into Onstage.

💡 Need Help Converting? If you have multi-preset SoundFont banks and need assistance converting them for Onstage, feel free to reach out to us and we will help optimize your sound files for live performance.

Licensing & License Key Activation

Unlocking features and transferring keys between devices.

Finding Licensing Options in Onstage

From the Start Page → tap the Full Version button (if in Demo mode) or tap the About Onstage button at the bottom of the screen.

Demo Mode vs. License Key Activation

There is only one Onstage app: Demo Mode and the Full Version are the same download, so installing it is always the first step. Onstage opens as a free, fully functional Demo Version with no expiration date (includes the Onstage Basics sound pack). Purchasing a License Key does not give you a separate app; entering the key activates the app you already installed and unlocks unlimited setlists and patches, 16 layer stacking, DSP effects, MIDI Patterns, and the Onstage Essentials pack with 33 sounds & 10 curated preset patches.

Feature Limit Demo / Free Tier Full License Key
Maximum Setlists 1 active setlist Unlimited
Maximum Patches per Setlist 2 patches Unlimited
Sound Layers per Patch Up to 3 layers Up to 16 layers
Scenes per Patch Up to 3 scenes Up to 5 scenes
Custom SoundFont (.sf2) Import Locked Full Access
Studio Audio Effects (EQ, Reverb, Delay) Locked Full Access
MIDI Patterns (Arp, Chord Triggers) Locked Full Access
Import / Export (Setlists & Patches) Locked Full Access

Transferring License to a New Device

Each License Key activates 1 device at a time (Windows, Android, or any future platform once supported by Onstage). If you switch phones or laptops:

  1. Open Onstage on your current device.
  2. Open About Onstage (from the Start Page).
  3. Tap the 'Licensed to <your email>' button to unlink your device.
  4. Enter your license key in Onstage on your new device to instantly activate it.