Connect MIDI Keyboard

Playing harmonium online with a computer keyboard is convenient, but a MIDI keyboard transforms the experience for your PC harmonium setup. You get velocity-sensitive keys, proper spacing, and the ability to practice real finger techniques on a full-sized online harmonium keyboard. This guide shows you how to connect any MIDI controller to Web Harmonium in under 5 minutes.

Step 1: Use a Compatible Browser

Web Harmonium uses the Web MIDI API to communicate with your keyboard. As of 2026, this API is supported in:

• Google Chrome (desktop & Android)
• Microsoft Edge (desktop)
• Opera (desktop)

Safari and Firefox do not yet support Web MIDI. If you are on macOS, use Chrome or Edge instead of Safari. On iOS, Web MIDI support is limited — use a laptop or Android tablet for the best experience.

Step 2: Plug in Your MIDI Keyboard

Connect your keyboard to your computer using the supplied USB cable. Most modern MIDI controllers are class-compliant, meaning they do not require special drivers.

Older keyboards with 5-pin MIDI DIN ports: You will need a MIDI-to-USB interface (such as the Roland UM-ONE or iConnectivity mio). Plug the MIDI OUT from your keyboard into the interface, then connect the interface to your computer via USB.

Step 3: Allow Browser Permission

Open webharmonium.vercel.app. When the browser detects a MIDI device, a permission prompt appears:

• Chrome/Edge: "webharmonium.vercel.app wants to use your MIDI devices" — click Allow.

If you accidentally blocked access, click the lock icon in the browser address bar, find "MIDI devices," and change it to "Allow."

Step 4: Select Your Device

In the top control bar of Web Harmonium, locate the MIDI Keyboard dropdown. Click the refresh icon () if your device is not listed. Select your keyboard by name — for example, "AKM320 by AKAI" or "MPK mini by Akai Professional."

Once selected, the app listens exclusively to that device. If you connect additional MIDI devices later, refresh the list again.

Step 5: Play and Adjust

Press a white key on your MIDI keyboard. You should hear a harmonium tone immediately. If the pitch feels too high or low for your voice:

• Use Octave buttons to shift the entire keyboard up or down by full octaves.
• Use Transpose to fine-tune in semitone steps until the scale matches your vocal range.

Enable Reverb for a room-like acoustic feel, and add Additional Reeds for a fuller, multi-reed harmonium tone.

Recommended MIDI Keyboards for Harmonium

Keyboard	Keys	Velocity	Price Range	Best For
Akai LPK25	25 mini	Yes	$50–$70	Travel, beginners
Nektar SE25	25 mini	Yes	$40–$60	Budget learners
Arturia MiniLab 3	25 mini	Yes	$100–$120	Pads + knobs included
M-Audio Keystation 49	49 full-size	Yes	$90–$120	Serious practice, two-hand play
Nektar Impact GX49	49 full-size	Yes	$80–$100	Best value full-size
Roland A-49	49 full-size	Yes	$150–$180	Premium feel, weighted option

Troubleshooting

Keyboard not detected

• Confirm you are on Chrome, Edge, or Opera.
• Unplug and reconnect the USB cable.
• Try a different USB port — avoid USB hubs if possible.
• Ensure the cable supports data transfer (some cables are charge-only).

Latency or delayed sound

• Close other browser tabs and heavy applications.
• Use headphones instead of Bluetooth speakers (Bluetooth adds audio delay).
• On Windows, update your audio drivers or switch to ASIO if using a DAW simultaneously.

Wrong note mapping

• Use the Transpose control to shift semitones until Sa aligns with your preferred key.
• Check if your MIDI keyboard has an octave shift button and reset it to default.

Frequently Asked Questions

Related Guides