MIDI overview
BackTrackR uses Core MIDI to trigger songs, control transport, arm loops, send optional messages when playback starts, and optionally send MIDI Clock or MTC. Timed patch/stomp cues live on the Timeline Control Track. Absolute show sync uses SMPTE / MTC / LTC.
All of this lives under Settings → MIDI & Timecode, with four tabs:
- Songs — chip MIDI (triggers / output / learn) or Timecode (starts, Follow/Off, auto-allocate, CueSync)
- Maps — Transport (Play / Pause / Stop / Next / Previous) and Loops A–L
- Sync — Send MIDI Clock, Send MTC, Chase, LTC input, fps, auto-regen
- Setup — destinations, Network/USB/virtual ports, Monitor log, note names
Compact In / Out lamps sit under the MIDI & Timecode title. You can also add MIDI in, MIDI out, and Timecode widgets via Settings → Layout.
Supported incoming messages: Note On/Off, Program Change, Control Change (CC), and system realtime Start, Stop and Continue. MMC SysEx Start/Stop/Continue is also recognised. Chase also accepts MTC and/or analog LTC on a hardware input.
Song triggers & output
Each song can have an Input mapping (incoming trigger) and an Output mapping (sent once when playback starts).
Input (incoming trigger)
- Power — turn the trigger on or off per song
- Ch / Type / Value — Note, Program Change, or CC (+ optional value; omit value to match any CC > 0)
- Learn — tap Learn, tap the Input row, then send MIDI from your controller or another app. Learn stays on if you switch apps to send the message. Leave the note empty until you choose one.
- Clear — remove the input mapping
Trigger action
Choose what happens when the input message is received:
- Select — select the song and preload/stage it in the engine without starting playback (useful when another app picks the song first)
- Play now — load and play immediately (global default)
- Add to cue — append the song to the active cue list
Set a global default at the top of the Songs tab, or override per song.
Output (on play)
When a song starts, BackTrackR can send a configured Note, Program Change or CC to external gear. Use the Test (↑) button on each song card to send the output without starting playback. Output requires power on and a valid mapping.
Duplicate triggers: If two songs share the same Input binding, an amber warning appears. BackTrackR matches the first mapping in order — change or clear duplicates to avoid wrong songs firing.
Enable Settings → General → Song list metadata → Show MIDI trigger to see each song's mapped trigger in the library, setlist and cue list. You can also drag that column’s position under the same settings — see Song list metadata.
Transport control
On the Maps tab, map Play, Pause, Stop, Next and Previous independently to Note, Program Change, CC, or MIDI transport messages (Start 0xFA, Stop 0xFC, Continue 0xFB).
Play behaviour
- If a song is selected but not yet loaded, BackTrackR waits for staging then starts playback.
- If the selected song is already loaded, playback resumes from the staged position.
- Song triggers and transport run on separate tasks so a rapid Select + Play (e.g. from OnSong) does not cancel preload.
Pause only acts when already playing. Stop stops transport and re-stages the current library or cue selection.
OnSong Sync preset
Tap OnSong Sync preset on Maps → Transport to quickly map Play → Start (0xFA) and Stop → Stop (0xFC). This matches OnSong's Sync → Start workflow.
Stop burst filtering: When BackTrackR is in the background, two or more Stop messages within ~450 ms are ignored (e.g. from opening the app switcher). A single intentional Stop after that window still stops playback.
MIDI Loops
On Maps → Loops, map Note, Program Change or CC messages to Loop A–L. Incoming messages use the same arm/disarm path as Timeline chips and shell Loop slot widgets — including At end / Now and bar quant.
- Empty slots do nothing
- Blocked under Performance lock
- Slot letters are global: MIDI “Loop A” always targets slot A on the loaded song
See also Loops A–L and Loops on stage.
MIDI Clock
Optional tempo sync out to hardware FX / sequencers — not MTC and not Control Track cues.
- Settings → MIDI & Timecode → Sync → Send MIDI Clock (off by default).
- While playing, BackTrackR sends Start + 24 PPQN Clock at the song’s BPM, then Stop on pause/stop.
- Per song in Edit → MIDI Clock: Follow (default) or Off.
Requires a known song BPM. Destination is the same MIDI output path as other song output.
OnSong workflow
Want the lyrics and songs inside BackTrackR instead? Use Import from OnSong. This page is only about using both apps live over MIDI.
If another app on the same iPad sends song-change and Start/Stop over MIDI, map those messages so BackTrackR selects and plays the backing track.
Recommended mapping
- Per song — Input: map OnSong's song-change message (often a Program Change or Note per chart).
- Per song — Trigger action: Select (or set global default to Select).
- Transport — Play: map OnSong Sync → Start (system realtime Start 0xFA). Use the OnSong Sync preset.
- Transport — Stop: map Stop 0xFC for full stop from OnSong.
Typical sequence
OnSong: change song → MIDI In → BackTrackR Select → preload/stage OnSong: Sync/Start → MIDI In → BackTrackR Play → load if needed, then play
Open OnSong before BackTrackR so its virtual MIDI ports appear under Setup → Connected app outputs. BackTrackR already listens to all MIDI sources except its own Out, so you usually do not need to select BackTrackR In manually.
When any song has an Input trigger or any Transport mapping exists, BackTrackR keeps the audio engine warm on the library tab to avoid cold-start errors when OnSong sends Play immediately after Select.
MIDI connections
Ports and destinations live under Settings → MIDI & Timecode → Setup. Tempo sync and absolute TC globals are on Sync — see MIDI Clock and Timecode.
Network (RTP)
- Toggle Enable Network MIDI for LAN connections (e.g. Mac on the same network).
- Send song output to: automatic (all network hosts) or one specific destination.
- First use may prompt for iOS Local Network permission.
USB
Class-compliant USB MIDI interfaces and controllers appear here. App virtual ports are not listed under USB — use Connected app outputs for those. Optionally pick a single USB destination for song output.
This iPad
- BackTrackR In — virtual destination (optional; app listens to all sources except BackTrackR Out)
- BackTrackR Out — virtual source other apps can receive from
- Connected app outputs — ports published by other apps (e.g. OnSong 2020, Session 1)
Note names & receiver alignment
Note names controls labels in the UI and monitor (stored note numbers never change):
- DAW / OnSong (C3 = middle C) — default; matches OnSong pickers
- Scientific (C4 = middle C)
Receiver monitor shifts sent note numbers only when your destination labels middle C as C3 (+12 semitones). Incoming labels and stored mappings are unaffected.
Background notifications
Under Settings → General, three optional toggles post iOS notifications while BackTrackR is in the background:
- Song selected and ready — after a MIDI Select trigger finishes staging
- Playing — when transport Play is received
- Stopped — when transport Stop is received
Monitor & troubleshooting
Under Setup, the Monitor log shows the last 120 MIDI messages with direction, endpoint, wire format and matched song or transport command. Enable Settings → Advanced → MIDI debug logging for detailed [MIDI] lines in Xcode when diagnosing timing issues.
Physical iPad required: Core MIDI input, learn mode and output testing do not work in the iOS Simulator.