How to connect your keyboard or digital piano
Plug the keyboard’s USB port, often labelled USB TO HOST, into your computer with a USB cable that carries data. Open Pianomi in Chrome or Edge and press Connect my keyboard. For most keyboards that’s all: no driver, nothing to install.
Which cable
Look at the back of the keyboard. Most have one of these sockets:
| Socket on the keyboard | The cable |
|---|---|
| Square USB (USB-B), often labelled USB TO HOST | A USB-B cable, the kind printers use. Its other end is USB-A for most computers, or USB-C for newer laptops, phones and iPads. |
| USB-C | A USB-C cable, or USB-C to USB-A for an older computer. |
| Round, with five pins (MIDI IN and OUT) | A USB-MIDI interface: see no USB port. |
Two USB sockets? USB TO DEVICE is for memory sticks: use USB TO HOST. And some cables only charge: if the keyboard isn’t found, try another cable first.
On a computer
Windows, Mac, Chromebook or Linux, in Chrome or Edge.
- Switch the keyboard on and plug it into the computer.
- Open Pianomi in Chrome or Edge.
- Press Connect my keyboard.
- The browser asks whether Pianomi may use your MIDI devices: choose Allow.
- Pianomi says it found your keyboard, by name. Then play the middle C it asks for.
Safari on a Mac can’t connect a keyboard: use Chrome or Edge there. Firefox can, but first asks to add a small site permission for MIDI: choose Continue to installation, then Add.
Pressed Block by mistake? Click the icon at the left end of the address bar, find MIDI (Chrome may call it “MIDI device
control”) and set it to Allow, then reload the page. In Chrome you can also paste
chrome://settings/content/midiDevices into the address bar (in Edge, edge://settings/content/midiDevices)
and take the site off the list of sites not allowed.
On an iPhone or iPad
Safari can’t take a cable, and neither can any other browser on iPhone and iPad: they all use Safari’s engine, which has no MIDI. The Pianomi app can.
- Get Pianomi on the App Store (free).
- Plug the keyboard in. An iPhone or iPad with a USB-C port: a USB-B to USB-C cable for a square USB socket, or a USB-C cable. One with a Lightning port: Apple’s Lightning to USB Camera Adapter, then the keyboard’s usual USB cable.
- Switch the keyboard on and open the app. It finds the keyboard by itself, with nothing to allow.
“This accessory requires too much power”? The keyboard draws its power from the phone. Use Apple’s Lightning to USB 3 Camera Adapter with a charger plugged into it, or a keyboard with its own power supply.
The app doesn’t take Bluetooth keyboards yet: use a cable.
On an Android phone or tablet
- Plug the keyboard in: a USB-B to USB-C cable for a square USB socket, or the keyboard’s usual cable with a USB-C (OTG) adapter.
- Switch the keyboard on and open Pianomi in Chrome.
- Press Connect my keyboard. Chrome asks whether Pianomi may use your MIDI devices: choose Allow.
Blocked it? Tap the icon at the left end of the address bar, then Permissions (or Site settings), find MIDI devices and set it to Allow.
Bluetooth keyboards
A Bluetooth keyboard can work, but less surely than a cable. Check first that it has Bluetooth MIDI: on many keyboards Bluetooth only plays music from your phone through the keyboard’s speakers, and can’t send your keys at all.
- Pair it in the system’s MIDI settings, not only in the usual Bluetooth list. On a Mac: open Audio MIDI Setup, choose Window, Show MIDI Studio, click the Bluetooth button and connect the keyboard. Then open Pianomi in Chrome or Edge.
- On Windows, browsers often don’t see a Bluetooth keyboard even once it’s paired.
- In Chrome on a phone it rarely works, and the Pianomi app on iPhone doesn’t take Bluetooth yet.
A USB cable is the sure way, and many Bluetooth keyboards have a USB port too.
No USB port on the keyboard
Round five-pin MIDI sockets only: use a USB-MIDI interface, a short cable with a USB plug at one end and two round plugs at the other. The keyboard’s MIDI OUT carries your keys. If nothing arrives, swap the two round plugs: the labels on some interfaces name the socket they go into, others the one they come from. On a phone or iPad, choose one with a USB-C plug or use an adapter.
No MIDI at all (many small and portable keyboards have only headphones and speakers): Pianomi can listen through the microphone instead. It’s good for one hand at your own pace; a keyboard with a USB cable gets every note right.
The keyboard isn’t found
Go down the list. Most problems are one of the first three.
- The keyboard is switched on.
- The cable carries data, not only power. Try another cable.
- It’s in USB TO HOST, not USB TO DEVICE (that one is for memory sticks).
- It’s plugged straight into the computer or phone, not through a hub.
- Unplug the keyboard, plug it back in, then reload the page.
- Close other music apps and other tabs that might use the keyboard: on Windows, often only one app at a time can use it.
- On Windows, some keyboards need their maker’s USB-MIDI driver. Search for your keyboard’s model and “USB MIDI driver” on the maker’s website.
- The browser is Chrome, Edge or Firefox (not Safari), and MIDI is allowed for the site (see on a computer).
Still nothing? Try the free MIDI keyboard test: if the keyboard doesn’t show up there either, it’s the cable, the port or the computer, not Pianomi. Or write to us with your keyboard’s model.
Found, but the keys do nothing
- Another app or tab may be holding the keyboard. Close it, unplug the keyboard, plug it back in and reload the page.
- The MIDI keyboard test shows every message the keyboard sends. If your keys appear there, they reach the browser.
- Pianomi hears your keys but the keyboard itself is silent? Its Local Control is probably off: turn it on in the keyboard’s settings (see its manual), or turn on Pianomi’s own sound.
- Notes an octave out? Pianomi asks for middle C as you connect, and corrects a keyboard that sends its notes an octave or two away.
Questions
Do I need a driver for my keyboard?
Usually not. Most keyboards and digital pianos made in the last fifteen years work as soon as they’re plugged in. Some, mostly older models, need their maker’s USB-MIDI driver on Windows: search for your keyboard’s model and “USB MIDI driver” on the maker’s website.
Which cable do I need?
It depends on the socket at the back of the keyboard. A square USB socket (often labelled USB TO HOST) takes a USB-B cable, the kind printers use, with a USB-A or USB-C plug at the other end to fit your computer, phone or tablet. A USB-C socket takes a USB-C cable. Round five-pin MIDI sockets need a USB-MIDI interface. Whichever it is, the cable has to carry data: some cables only charge.
Can I connect a keyboard to an iPhone or iPad?
Yes, with the Pianomi app from the App Store, but not in a web browser: every browser on iPhone and iPad uses Safari’s engine, which can’t connect MIDI devices. Newer iPhones and iPads with a USB-C port take a USB-C cable; older ones with a Lightning port need Apple’s Lightning to USB Camera Adapter.
Does a Bluetooth keyboard work?
Sometimes. A Bluetooth MIDI keyboard has to be paired in the computer’s MIDI settings first, such as Audio MIDI Setup on a Mac. Browsers on Windows and on phones often don’t see Bluetooth keyboards at all, and the Pianomi app on iPhone doesn’t take Bluetooth yet. A USB cable is the sure way.
Plug in and play
Pianomi finds your keyboard and marks every note you play. Nothing to install, and it’s free.
Open Pianomi