Petal.THE FIELD GUIDE / iOS APP
WRITE YOUR CUES / 06
THE SONG LIBRARY

A structure for
every change.

A song combines musical timing with the events your rig should perform. Set the foundation before filling in the timeline.

TempoTime signatureSong structure
01

Set the song’s timing.

In Songs, tap + to create a song. Set its name, tempo, and time signature, then build the song structure.

Tempo determines the relationship between beats and elapsed time. The time signature helps organize the timeline into measures and beats. Get both right before rehearsing timed MIDI changes.

02

Build sections you can recognize.

Use sections to divide the song into meaningful parts, such as an intro, verse, chorus, and bridge. Set each section’s musical length and use colors to make the structure easy to scan.

Keep the structure close to what you actually play. Section boundaries are also useful navigation points when rehearsing with previous/next section commands.

Changing the foundation

Some song edits can prompt you to reset the structure. Read that prompt before confirming, particularly after you have placed events.

03

Prepare the beginning and end.

The song editor includes start and stop event areas. Use them to define the changes you need when entering or stopping a song. Presets and patches let you reuse these changes instead of rebuilding MIDI messages.

Events at the beginning of the song can fire during program loading. Test how choosing a song prepares your rig, as well as how it behaves when you press Play or Stop.

04

Manage the library.

The Songs list is alphabetically sorted. Use Edit to show trash buttons; the add button is hidden while editing. Deleting a library song asks for confirmation and includes Cancel.

Removing a song from a performance is different: that removes its place in that performance, not the underlying song from your library.

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.