ZOMG MIDI Triggers (aka "Make Your Foot Pedal Do Stuff")

A MIDI trigger connects an incoming MIDI message — from a foot controller, expression pedal, or control surface — to an action in OnSong, so your hardware can basically run the whole show while you just stand there lookin' pretty. This screen sets up a single trigger. Your changes save as you make them, so just tap You're Done, Buddy when you're finished fiddlin' around.

Which options show up depends on what kinda controller you're hooked up to, but every trigger starts with these two absolute must-haves:

MIDI Event (aka "The Incoming Blip")

A MIDI Event is the incoming message that fires the trigger — a note, a control change (CC), whatevs. Tap to choose the message & its channel; the row shows your choice, like "CC 4 on Channel 1" (riveting stuff, we know).

Action (aka "What OnSong Does Next")

The Action is what OnSong does when the trigger fires. Tap to pick from the action chooser; the row shows the assigned action, or "Unassigned" (whoops, you forgot). For a variable control change like an expression pedal or knob that sends a smooth 0–127 sweep, you'll also peep:

Response Curve (aka "How Smooth You Want It")

The Response Curve shapes how the controller's travel maps to the action. Basically, it's the difference between smooth & janky.

• Linear — the controller & the parameter move together, 1:1. Boring but honest.
• Logarithmic — most of the travel works at the quiet end; great for a natural volume feel that doesn't make you sound like a robot.
• Exponential — most of the travel is subtle, & the top of the range pushes hard. For when you gotta go from "huh?" to "WHOA" real fast.
• S-Curve — stable at the extremes & fast through the middle; good for crossfades & pretendin' you're a radio DJ.

Minimum & Maximum Value (aka "Stay in Your Lane")

These clamp the input event's useful range within 0–127. Anything outside the range gets ignored, so you can dial in exactly the sweep you want without accidentally yeeting to 127. The minimum always stays below the maximum (shocking, we know).

For a momentary control, like a button or switch sendin' a CC, you'll see these instead (because apparently every controller works different):

Behavior (aka "How Your Button Acts")

Behavior decides how presses map to the action. Tap the row to cycle through & pick your poison:

• Momentary — active once a value greater than 0 is received. Press & hold = on. Let go = off. Classic.
• Latch — fires the action on both edges, but with no on/off value. Press fires it once, release fires it again, each just a plain action. Use it when your controller sends a separate press & release message & you want the action to respond to both (nerd alert).
• Toggle — treats the action as an on/off state. Crossin' the threshold on the way up sends the "On" action while droppin' back below sends the "Off" action. Use this for anything with a held state like a mute, a hold, a light, or your dignity.

Threshold (aka "The Magic Number")

This is the value at or above which the controller counts as on. Values below it get straight-up ignored. It defaults to 1 for Momentary & 64 for Toggle (we dunno why either, ask the nerds).

Inverted (aka "Oops, It's Backwards")

This setting reverses the input value direction. 0 becomes 127 & vice versa. Handy when a pedal is mounted or wired backwards & you can't be bothered to physically fix it like a normal person.

Active (aka "On/Off Switch")

This turns the trigger on or off. Switch it off to suspend the trigger without deletin' the binding, so you can bring it back later when you're ready to stop procrastinatin'.