MIDI controller setup for online harmonium practice
How to connect a USB MIDI keyboard to the online harmonium in your browser, with troubleshooting for the most common problems.
Last updated 4/16/2026
Beginner · ~6 min
Why use a MIDI keyboard with an online harmonium?
The on-screen harmonium works fine with a mouse or QWERTY keyboard, but neither matches the feel of pressing real keys. A USB MIDI controller gives you:
- Velocity-independent tone (matches a real harmonium — no accidental dynamic swells)
- Full polyphony without struggle (drone Sa with one hand, melody with the other)
- Multi-octave range in your hands rather than relying on octave shift buttons
- Muscle memory that transfers directly to a physical harmonium when you eventually buy one
Hardware recommendations
You don’t need an expensive controller. The cheapest 25-key MIDI keyboards (around $50/₹4,000) work perfectly. For Hindustani practice, look for:
- 49+ keys — a 25-key model is enough for one octave + some flex, but two octaves (49 keys) covers 95% of raga work
- No weighted action — harmonium keys are spring-loaded with very light resistance; cheap MIDI keys are actually closer to the real feel than premium weighted controllers
- USB-class compliant — the keyboard should work without driver installation on Chrome/macOS/Windows. All major brands (Akai, Arturia, M-Audio, Novation, Korg) ship class-compliant devices.
Browser-side: Web MIDI permission
When you first open a page on this site that uses MIDI, your browser will prompt:
“playharmoniumonline.com wants to control your MIDI devices.”
Click Allow. The permission is stored per-origin, so you only do this once per browser. If you accidentally click “Block”, you can re-enable in your browser’s site settings:
- Chrome: Settings → Privacy and security → Site settings → MIDI devices
- Edge: Settings → Cookies and site permissions → MIDI device control
- Firefox (Android only): about:config → dom.webmidi.enabled
Multiple MIDI devices
If you have more than one MIDI device connected (e.g., a keyboard and a drum pad), our MIDI test tool lets you select which device feeds the harmonium. Use the dropdown above the keyboard.
Common controllers and their quirks
- Akai MPK Mini — works flawlessly. Octave buttons map to ± one octave, sustain via mod wheel.
- Arturia MicroLab — works flawlessly. The included Arturia Lab software is unnecessary for browser use.
- M-Audio Keystation — works flawlessly on USB. Pitch wheel is detected but ignored by our harmonium (no pitch bend on a real harmonium).
- Korg nanoKEY2 — works flawlessly. Velocity is sent and ignored by our harmonium engine.
- Novation Launchkey Mini — works, but the pad layout is irrelevant for harmonium use; treat it as a 25-key keyboard.
What if I don’t have a MIDI keyboard?
Use the QWERTY mapping built into our keyboard widget:
| QWERTY key | Note (Sa = C4) |
|---|---|
| Z | C (Sa) |
| X | D (Re) |
| C | E (Ga) |
| V | F (Ma) |
| B | G (Pa) |
| N | A (Dha) |
| M | B (Ni) |
| , | C5 (Sa^) |
Black keys map to the row above (S, D, G, H, J for the sharps). The Q-row plays the upper octave. This works in any modern browser without permissions.
Steps
-
Use a Web MIDI compatible browser
Chrome, Edge, and Opera support Web MIDI natively on macOS, Windows, and Linux. Firefox supports it on Android only. Safari does not support Web MIDI as of 2026 — switch to Chrome if you are on a Mac.
-
Connect your MIDI keyboard via USB
Plug the keyboard directly into a USB port. Avoid USB hubs if possible — they sometimes block MIDI traffic. Wait 5 seconds for the device to enumerate.
-
Open the online harmonium
Navigate to the [Play page](/play/) or any tool with a keyboard. The browser will show a permission prompt asking to access MIDI devices.
-
Grant MIDI permission
Click "Allow" on the permission prompt. The site stores this permission per-domain — you only have to grant it once. Your keyboard should now appear in the MIDI device list at the bottom of the page.
-
Test the connection
Press any key on your MIDI keyboard. The corresponding key on the on-screen harmonium should light up and produce sound. If it does not, check the troubleshooting section below.
FAQ
Frequently asked questions
My keyboard does not show up in the device list. What now?
Three things to check: (1) your browser supports Web MIDI — Chrome/Edge/Opera on desktop are safe bets; (2) you granted MIDI permission when prompted (try refreshing the page); (3) the keyboard is recognised by your operating system at all (open a system MIDI utility like Audio MIDI Setup on macOS or check Device Manager on Windows).
My MIDI keyboard plays but every note is one octave off.
This is a transposition setting on your keyboard, not a problem with our site. Most controllers have an "octave +/-" button or pad that shifts the entire keyboard. Press the down-octave button until middle C on your keyboard plays middle C on screen.
Can I use a Bluetooth MIDI keyboard?
Yes, but only on browsers that support Web MIDI over Bluetooth. As of 2026, Chrome on macOS and Windows supports Bluetooth MIDI, but pairing is finicky. Wired USB is much more reliable for practice. If you need wireless, an iOS app + bluetooth-to-USB bridge is the most stable workaround.
Does MIDI velocity affect harmonium tone?
A real harmonium has no velocity sensitivity — air pressure depends on the bellows, not key force. Our online harmonium follows the same convention: every note plays at the same volume regardless of MIDI velocity. The volume control is set by the bellows knob (or the in-app volume slider), not your keystroke.