Petal.THE FIELD GUIDE / iOS APP
WRITE YOUR CUES / 07
THE MUSICAL TIMELINE

Put the right change
on the right beat.

The timeline is where saved sounds become a performance: place discrete changes, shape continuous ones, and rehearse the result.

Musical positionsPreset eventsContinuous control
A SONG IN MOTIONINTERACTIVE APP ILLUSTRATION
Midnight Drive 4/4 Time • 120 bpm
1
1234
2
1234
3
1234
4
1234
5
1234
6
1234
7
1234
8
1234
9
1234
10
1234
11
1234
12
1234
FIG. 01   The playhead stays still. Your song moves.Intro · Bar 1 of 12

The illustration plays when it comes into view. Pause it, drag the timeline, or pan the overview. Section titles stick at the leading edge until the next section takes over. Illustration only; no MIDI or audio is sent.

01

Read the timeline.

The playhead shows your current position against the song’s section and beat structure. Event markers represent discrete changes. Ramps represent a control changing over a span of time.

Use the timeline editor to work with sections, events, and ramps. Playback view and edit view have different jobs: rehearse in playback, then return to editing when you need to change the song.

02

Place preset and patch events.

Add a preset or patch event at the musical position where you want the change. Use a device preset for a single-device instruction, or a patch when the cue needs a combination of saved presets.

Rehearse the lead-in and the moments after the event. A cue can be sent at the intended position while the receiving hardware still takes time to switch sounds. Verify the audible result, not only the onscreen marker.

03

Shape changes with ramps.

A ramp changes a device control across a duration rather than sending a single fixed value. Choose the device and control, then configure the available range, duration, and curve settings.

Use a ramp for an illustrative gradual effect change, such as increasing a delay amount over a phrase. The receiving device must support the selected MIDI control and values.

No controls available?

Define the device’s controls first. The ramp editor needs a control to target; a device name alone does not tell Petal which MIDI CC to change.

04

Test the transitions.

  • Play through the cue from an earlier position.
  • Pause and resume around the change.
  • Seek or navigate between sections and confirm the rig reaches the expected state.
  • Try the same song again after loading a different song.

Event notifications produce a ripple on the timeline. Use the visual feedback as a cue that an event was reported, then listen to the connected hardware to confirm the actual result.

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.