Petal.THE FIELD GUIDE / iOS APP
REFERENCE / 10
HANDS-FREE CONTROL

Small messages.
Big moves.

Use external MIDI CC messages to request playback and navigation through a compatible connected controller.

CC 101CC 102Channel 16 by default
01

Performance command table.

Send these on the song program’s listening channel, initially channel 16. Set Petal’s Incoming MIDI channel to suit your controller. These commands are implemented by Petal-compatible firmware; verify your device’s firmware support.

ActionCCValue
Play1013
Pause1014
Stop1015
Previous section1016
Next section1017
Go to song102Song position, 0–127
02

Song positions start at zero.

For CC 102, value 0 selects the first song in the performance, value 1 the second, and so on. This is a position in the running order, not a song’s name or library identifier.

Example

To request the third song, send CC 102 with value 2 on the configured incoming channel. Open the intended performance first.

03

How a footswitch starts playback.

Footswitch CC→Connected controller→Petal app→Playback

The controller sends a request back to the app, which performs navigation and playback. These CCs do not directly start playback without an app connection. Previous and next song are not assigned additional CC 101 values in the current implementation; use CC 102 to choose a song by position.

Control Change numbers and values are 7-bit MIDI data: 0–127. Device-specific preset controls are separate from this Petal performance command table.

Your music. Your cues. Your moment.Guide edition · October 2026
The basics / Meet PetalMeet Petal

A field guide to turning your MIDI rig into a performance that moves with your music. Build the changes once. Be present when they happen.

The basics / Meet PetalYour performance, connected.

Petal is an iOS app for organizing MIDI devices, reusable sounds, song timelines, and performances. A compatible connected controller handles th…

The basics / Meet PetalFour tabs. One connected rig.

♫ ↗ Songs Your library of songs, musical structure, and timed changes. ☷ ↗ Performances Arrange your songs into the order the nig…

The basics / Meet PetalFind your starting point.

New rig? Follow Your first performance . Already have sounds saved? Jump to the timeline . At rehearsal with something not responding? Open T…

The basics / Your first performanceYour first performance

Start small: one device, one saved preset, one song. Get that working before building your whole show.

The basics / Your first performanceA simple setup, step by step.

Sign in to Petal Choose Apple, phone, or Google on the welcome screen. Complete the provider’s sign-in flow. Sign-in is portrait; the authent…

The basics / Your first performanceBefore you press Play.

Check three things: connection , receiving channel , and saved changes . Keep your test message simple enough that you can hear or see the re…

The basics / Your first performanceBuild up in layers.

Once one cue works, add a second device or create a patch that combines several presets. Then add timed changes, ramps, and the rest of your p…

The basics / Connect your rigConnect your rig

Petal supports compatible MIDI controllers over USB or Bluetooth. The connected controller bridges your song program to your MIDI gear.

The basics / Connect your rigConnect with USB.

Connect your supported controller to the iPhone or iPad using the appropriate USB cable or adapter. Open Petal and allow it to discover and ve…

The basics / Connect your rigPair over Bluetooth.

Enable Bluetooth and grant Petal Bluetooth permission. Put the compatible controller in its normal advertising state and keep it close to your…

The basics / Connect your rigSeparate the two MIDI channels.

Your rig has two different channel choices. A device’s MIDI channel targets the gear receiving its preset messages. Petal’s Incoming MIDI cha…

The basics / Connect your rigWhen the connection changes.

Petal synchronizes playback timing with the connected device when the active transport changes and refreshes the clock mapping periodically. Let…

Build your rig / Devices & presetsDevices & presets

Devices hold the details your MIDI messages need: channel, controls, colors, and saved presets.