# MIDI compatibility

MIDI gear connects in several ways, and not every device can use all of them. Whether your gear works with Songstead mostly comes down to how it connects and what you connect it to.

> [!PLAN] Backstage
> MIDI needs Backstage.

## At a glance

| Connection        | Good for                                       | Watch out for                                                    |
| ----------------- | ---------------------------------------------- | ---------------------------------------------------------------- |
| USB               | Anything with a USB port. The most dependable. | A cable to run, and an adapter for most phones and tablets.      |
| 5-pin MIDI        | Older keyboards, rack gear and many pedals.    | Needs a USB MIDI interface in between.                           |
| Bluetooth         | Footswitches and small controllers, no cable.  | Batteries, pairing, a slight delay, and little support on Windows. |
| Network (Wi-Fi)   | Linking a tablet to a computer in your rig.    | Only as reliable as the network. Not on Android.                 |

| Device       | Use                     | USB | Bluetooth                       | Network             |
| ------------ | ----------------------- | --- | ------------------------------- | ------------------- |
| iPhone, iPad | The Songstead app       | Yes | Yes, with **Pair Bluetooth**    | Yes                 |
| Android      | The Songstead app       | Yes | Yes, with **Pair Bluetooth**    | No                  |
| Mac          | Chrome, Edge or Firefox | Yes | Yes, paired in Audio MIDI Setup | Yes                 |
| Windows      | Chrome, Edge or Firefox | Yes | Limited                         | With extra software |

## USB

Most modern MIDI controllers, footswitches and keyboards plug straight in over USB and need no setup. USB is the most dependable way to connect: there's nothing to pair, no batteries to run down, and no delay you'd notice.

- **iPhone and iPad:** A model with a USB-C port takes the device's cable directly, or through a USB-C adapter or hub. A model with a Lightning port needs Apple's Lightning to USB Camera Adapter.
- **Android:** Most phones and tablets take a USB device through a USB-C adapter.
- **Power:** A phone or tablet can't always power a device that draws its power over USB. A powered USB hub between them fixes that.
- **Windows:** A USB MIDI device can often be used by only one program at a time. If Songstead can't see a device, close other music software.

## 5-pin MIDI

Many keyboards, amp modelers, effects units and rack gear have round 5-pin MIDI ports instead of USB. They connect through a USB MIDI interface, which plugs in like any USB device.

Each of the interface's ports shows up in Songstead as a device of its own. Gear chained from one port shares it, so give each piece of gear its own MIDI channel.

Small pedals often have a 3.5 mm MIDI jack instead, called TRS MIDI. These need an adapter to 5-pin, and there are two wiring standards, Type A and Type B. Check which one your pedal uses before you buy an adapter.

## Bluetooth

Bluetooth MIDI connects without a cable, and has a few drawbacks:

- **A slight delay**, too small to notice on a page turn, but sometimes felt when playing notes.
- **Batteries** in the pedal, which you'll want charged before a gig.
- **Dropouts** at a distance or in a room full of phones. Keep the device within a few meters.

A Bluetooth MIDI device doesn't connect through the ordinary Bluetooth settings. Pair it in the right place for what you're using:

- **iPhone, iPad and Android:** Select **Pair Bluetooth** beside **Devices** on the **Setup** tab of the **MIDI** page, and choose the device. Songstead connects it again the next time MIDI starts.
- **Mac:** Open Audio MIDI Setup, choose **Window**, then **Show MIDI Studio**, and select the Bluetooth button to connect the device.
- **Windows:** Windows has little support for Bluetooth MIDI, and the browsers on it often can't see a Bluetooth MIDI device even once it's paired. Use USB, or a Bluetooth MIDI adapter that plugs into a USB port.

A Bluetooth page-turner that types arrow keys isn't a MIDI device, and needs none of this. See [Foot pedals and shortcuts](https://songstead.app/docs/foot-pedals.md).

## Network MIDI

Network MIDI, also called RTP-MIDI or Apple MIDI, carries MIDI over Wi-Fi or a wired network. It can link an iPad running Songstead to a computer running your rig.

- **iPhone and iPad:** With MIDI turned on, the Songstead app can be reached over the network. Connect to it from the other computer, such as a Mac's MIDI Network Setup.
- **Mac:** Network MIDI is built in, under MIDI Network Setup in Audio MIDI Setup.
- **Windows:** Network MIDI needs extra software, such as rtpMIDI.
- **Android:** Android doesn't support network MIDI.

Network MIDI is only as steady as the network under it. A venue's Wi-Fi, shared with an audience, is a poor choice. A small router of your own, or a network cable, keeps it reliable.

## Browsers

On a computer, Songstead runs in a browser, whether you open it there or install it as an app.

| Browser          | MIDI                                                                                     |
| ---------------- | ---------------------------------------------------------------------------------------- |
| Chrome           | Yes.                                                                                     |
| Edge             | Yes.                                                                                     |
| Firefox          | Yes. The first time, Firefox asks to add a site permission for songstead.app. Allow it. |
| Safari           | No. On a Mac, use Chrome, Edge or Firefox.                                               |

Every browser on iPhone and iPad is built on Safari's engine, so none of them can reach MIDI devices. Use the Songstead app instead.

## Sharing a device with other apps

On iPhone, iPad and Mac, several apps can use one MIDI device at the same time. On Windows, the first program to open a device often keeps it to itself.

In the Songstead app, turning MIDI off lets go of your devices, so other apps can have them.
