Blog

How to check USB MIDI discovery before a lesson

Check whether your browser detects a USB MIDI keyboard before class, then trace connection, permission, or browser problems with a quick test.

Ryan MitchellHardware tests Tests 5 min read

You connect a USB MIDI keyboard before class, but the music software does not show it. Before students arrive, check whether the computer recognizes the device and whether the browser can receive its MIDI messages. That helps narrow down whether the problem is the cable, browser permission, or the keyboard itself.

Use the MIDI Test to check for incoming notes and controller messages without opening a music program. It can show key presses, velocity, knobs, pedals, and other MIDI data.

Check MIDI discovery before class

  1. Open the MIDI Test in a browser that supports Web MIDI. The test does not work in Safari, so use another supported browser if you are on a Mac.
  2. Connect the MIDI keyboard directly to the computer with a USB cable that supports data. If the browser asks for access to MIDI devices, allow it for the test page.
  3. Find the keyboard in the test's MIDI device area, then press and release a few keys. Try a low note and a high note, and turn a knob or press the sustain pedal if you need to check those controls too.
  4. Watch for incoming messages while you play. Repeat the check after disconnecting and reconnecting the keyboard if it does not appear the first time.

Some keyboards need external power or batteries in addition to USB. Check the keyboard's display or power light, and make sure the cable is connected to the keyboard's USB port rather than a port intended for a USB flash drive.

What the result means

The keyboard appears and messages arrive

The computer and browser can see the keyboard, and it is sending MIDI data. If the music software still cannot use it, check that software's MIDI input selection. You may need to select the keyboard by name and enable it as an input. A browser test confirms the connection to the browser, not the settings inside another app.

The keyboard appears, but no messages arrive

The browser can identify a MIDI device, but it is not receiving the key or control events you are testing. Check whether the keyboard is in the right mode, whether the chosen control sends MIDI, and whether the USB cable is firmly connected. Test multiple keys instead of relying on one possibly faulty key.

The keyboard does not appear in the test

The browser has not exposed a MIDI input to the test. Permission may be blocked, the browser may not support Web MIDI, or the operating system may not recognize the keyboard. Use the fixes below to check each layer in order.

The keyboard appears only after reconnecting

The device may have taken time to initialize, or the browser may not have refreshed its device list. Reconnect it before class and test again. If the problem repeats, try another USB port and check whether the computer recognizes it outside the browser.

How to fix MIDI discovery

  1. Confirm the browser supports MIDI. Safari does not support the MIDI Test. Try a current browser that supports Web MIDI, then reload the page and reconnect the keyboard.
  2. Allow MIDI access for the page. If a permission prompt appears, choose the option to allow access. If you previously blocked it, click the site controls beside the address bar, open the page's permissions or site settings, and allow MIDI device access if that setting is listed. Reload the page afterward.
  3. Check the USB connection. Use a different data-capable cable and a USB port on the computer rather than a hub or dock. Some cables provide power only. If a hub is necessary for the classroom setup, test the keyboard directly first to isolate the hub.
  4. Check whether the operating system sees the device. In Windows 11, right-click Start, open Device Manager, and look under Sound, video and game controllers or Universal Serial Bus devices. On macOS, open Applications › Utilities › Audio MIDI Setup, then choose Window › Show MIDI Studio. A keyboard missing there may have a cable, port, power, or driver issue.
  5. Close other music software. Quit any digital audio workstation, piano app, or MIDI utility that may be using the device. Reopen the browser test and check again. Some applications or drivers do not share a MIDI input cleanly.
  6. Restart the browser, then the computer. Close the browser completely and reopen it. If the device still is not listed, restart the computer with the keyboard unplugged, then connect it after the desktop is ready.
  7. Install the keyboard maker's driver only if needed. Many keyboards work as standard USB MIDI devices without a separate driver. If the manufacturer requires one for your model, install the current driver from its official support source and restart before testing again.

When the keyboard or cable may be faulty

Try the keyboard with a second known-good data cable and another USB port. If possible, connect it to a second computer and check whether its power light comes on and whether notes are detected there. If it is not recognized on multiple computers with different cables, check the manufacturer's troubleshooting guidance or warranty options. A damaged USB port or keyboard electronics may need repair. Avoid forcing a connector that feels loose or bent.

What a browser MIDI check can and cannot confirm

The MIDI Test checks whether MIDI input reaches the browser. It does not produce sound from the keyboard, test a piano's speakers, or prove that a music app is configured correctly. MIDI is control data: a note message tells software which note was pressed, while the software or a connected instrument supplies the sound.

For a classroom check, test the exact keyboard, cable, USB port, and browser you plan to use. If the test receives notes but the lesson software stays silent, the next step is to select and enable that MIDI input inside the lesson software.

More articles