Connect your keyboard
Clefsight listens to your keyboard through a USB cable and the browser, so it knows every key you press and when. Most digital pianos and keyboards sold today connect with one cable and no driver.
What you need
- A keyboard with a USB port that sends MIDI. Look on the back for a square USB socket (often labelled “USB to Host”) or a USB-C socket. A flat USB-A socket on the keyboard is usually for a memory stick, not for a computer.
- A USB data cable from that socket to your computer, phone or tablet. A phone charging cable may carry power only.
- Chrome or Edge on a computer or an Android phone or tablet, or Firefox on a computer. Safari, iPhone and iPad can't connect a keyboard to a web page.
On a computer
- Switch the keyboard on and plug it into the computer. No driver is needed for most keyboards; Windows and macOS find them on their own.
- Open clefsight.com in Chrome, Edge or Firefox and press Start reading.
- The browser asks once whether the site may use MIDI devices: allow it. Firefox asks to add a small permission add-on for the site instead; add it.
- The dot at the top right turns green and shows your keyboard's name. Play a key on the level test to see it answer.
On an Android phone or tablet
Use Chrome. Most phones and tablets need a cable or adapter with USB-C on the phone or tablet end and your keyboard's socket on the other (USB-C to USB-B for the square socket). Plug in, open clefsight.com, press Allow keyboard and allow it when the browser asks.
Bluetooth keyboards
On a Mac, pair the keyboard first: open Audio MIDI Setup, choose Window → Show MIDI Studio, press the Bluetooth button, and Connect next to your keyboard. Then it shows up in the browser like a cable. On Windows and Android, a Bluetooth keyboard often doesn't reach the browser; the USB cable always does. Over Bluetooth, timing wobbles by about a hundredth of a second, so tick It's a Bluetooth keyboard in Settings and the timing windows widen to match.
When the keyboard isn't found
- “No keyboard found.” Try another cable first: a charge-only cable is the most common cause. Switch the keyboard on before pressing Allow keyboard, and plug straight into the computer rather than through a hub.
- Another program has it. On Windows a keyboard can often be open in only one program at a time. Close other music programs (a recording app, a piano game), then reload the page.
- “The browser was refused access to MIDI.” Click the icon to the left of the address, set MIDI devices to Allow for clefsight.com, and reload.
- “This browser can't connect a MIDI keyboard.” You're in Safari or on an iPhone or iPad. Open clefsight.com in Chrome or Edge on a computer or an Android phone or tablet, or in Firefox on a computer.
- Two keyboards, or the wrong one. Pick the one to listen to in Settings → Keyboard.
- An older keyboard with round 5-pin MIDI sockets and no USB. A USB MIDI interface cable connects its MIDI OUT socket to the computer.
- No sound when you play. A controller with no speakers is silent on its own; tick Play my keys through the speakers in Settings.
Then check the timing: Settings has a short tap-along that measures your keyboard's and speakers' delay, so early and late are judged fairly.
How many keys you need
The 825 pieces in the library reach from A0 to A7. This is how many of them fit on each common size:
| Keyboard | Lowest to highest key | Library pieces that fit |
|---|---|---|
| 49 keys | C2 to C6 | 486 of 825 |
| 61 keys | C2 to C7 | 658 of 825 |
| 76 keys | E1 to G7 | 800 of 825 |
| 88 keys | A0 to C8 | all 825 |
So 61 keys play 658 of the 825 as written. Only Largo (Ombra mai fu), from Serse, Sailor's Song, Op. 68 No. 1, An Important Event, from Kinderszenen, Bethena, Erotik, Op. 43 No. 5, Funeral March of a Marionette, Golliwogg's Cake-walk, from Children's Corner, In the Hall of the Mountain King, Op. 46 No. 4, Jesu, Joy of Man's Desiring, Little Bird, Op. 43 No. 4, Melody in F, Op. 3 No. 1, Norse Song, Op. 68 No. 41, Possum and Taters, Rider's Piece, Op. 68 No. 23, Valses poéticos No. 7, Waltz of the Flowers, from The Nutcracker, Butterfly, Op. 43 No. 1, Notturno, Op. 54 No. 4, Prelude in A flat, Op. 28 No. 17, Prelude in C minor, Op. 28 No. 20, Rêverie, Shepherd's Boy, Op. 54 No. 1, Summer's Eve, Op. 71 No. 2, Intermezzo in A minor, Op. 116 No. 2, Rustle of Spring, Op. 32 No. 3 need more than 76. If you are buying a first keyboard to learn on, 88 full-size keys with weighted action feel like a piano and never run out; for reading alone, any size with a USB port will do to start. Choosing one? Which keyboard to buy goes through keys, touch, connections and the pedal, kind by kind.
Questions
Which browsers can connect a keyboard?
Chrome and Edge on Windows, macOS, ChromeOS and Linux, Chrome on an Android phone or tablet, and Firefox on a computer (it asks once to add a small permission add-on for the site). Safari can't, and on an iPhone or iPad no browser can, because iOS doesn't let web pages reach MIDI.
Do I need a digital piano, or will any keyboard do?
Any keyboard that sends MIDI over USB works: a digital piano, a home keyboard or a controller with no sound of its own. Clefsight reads which key you pressed, when and for how long; the keyboard's own sound doesn't matter. A controller with no speakers can play through your computer: tick “Play my keys through the speakers” in Settings.
Does a Bluetooth keyboard work?
On a Mac, yes, once it is paired in Audio MIDI Setup. On Windows and Android a Bluetooth keyboard often doesn't reach the browser, so use the USB cable there. Bluetooth timing wobbles a little more than a cable, so tick “It's a Bluetooth keyboard” in Settings and the timing windows widen to match.
Why isn't my keyboard found?
Most often the cable: many USB cables only charge and carry no data. Then a keyboard switched on after the page opened (reload the page), another program that already has the keyboard open (close it, then reload), or MIDI refused for the site in the browser's settings.
What can't Clefsight tell from a keyboard?
Fingering, hand position, posture and tone don't come through a keyboard's signal, so Clefsight doesn't grade them; it hears which key you pressed, when, how hard and for how long. The library goes up to level 7: advanced pieces such as Chopin's Fantaisie-impromptu. Beyond that, what matters most (voicing, pedalling, phrasing, rubato) is what a keyboard's signal says least about, so Clefsight is for learning to read and play, not for polishing a recital. The library is public-domain music only: pieces old enough to be free in both the United States and Canada, and traditional tunes. Modern songs, pop and film music aren't in it; you can bring your own score as MusicXML or a MIDI file.
Ready? Allow your keyboard and take the level test: a few minutes of notes, shapes and rhythm that find what you already read, so you start at your level.
Allow keyboard and startNo keyboard yet? Which keyboard to buy says what to look for. The note drills work on screen meanwhile, so does the note reading game, and the reading guides need nothing at all.