Repository navigation
Releases
Keylight 1.0
Keylight 1.0
A free, open-source piano teacher for light-up keyboards. Notes fall, your keys glow, and the song waits for you. Website: https://keylightpiano.app
Download
| Platform | File | Notes |
|---|---|---|
| Mac | Keylight-1.0.0-mac.dmg |
Apple silicon, macOS 13 or newer. Not notarized, so macOS asks you to confirm the first time you open it. |
| Windows | Keylight-1.0.0-win-x64-Setup.exe |
Windows 10 or 11, 64-bit. Beta. Unsigned, so Windows may show a warning. A portable Keylight-1.0.0-win-x64.zip is also attached. |
| Android | Keylight-1.0.0-android-release.apk |
Android 8.0 or newer. Beta. Open the file on your phone or tablet to install it. |
iPhone and iPad are coming to the App Store as a paid app. The app already runs on them; it is published by the maintainer, so please do not put a copy of Keylight on the App Store before it is out. Mac, Windows and Android stay free.
Checksums (SHA-256) are in SHA256SUMS.txt.
Windows and Android are beta
Both are built and tested automatically, and the Android app was run on an emulator, but neither has been tested on many real devices. If something is wrong, please open an issue and it will get fixed.
New since 0.2.4
- A course. Twelve levels and 94 short lessons, from finding middle C. You can open anything: the course suggests what is next and never locks.
- Practice tab. Ear training, rhythm, sight-reading, play it back, scales and chords, games, a metronome and the Playground, each with levels and your best result.
- Jam. Build a groove in layers: drums, bass, chords and lead loops, with delay, reverb, scale lock and MIDI export.
- Sheet only view, with the due note glowing in the colour of its hand. Plus a drop-down for the instrument and six new sounds.
- Back goes back. The Back button, Escape and the phone's Back button return to the previous page.
- 57 classical pieces added to the library.
- Android app and a Windows installer.
- Saved data is safer. Progress and imported songs now live at a fixed address, so they cannot disappear if a network port is busy, and Keylight keeps the last three daily backups.
- Keyboards that announce their bend range (MPE) are now followed.
- A gentle support card on Home, at most every two weeks, with Maybe later and Don't ask again.
- Experimental: the Airwave test report now checks the camera driver and tells you the likely fix. Finger tracking from the Airwave is still unconfirmed.
If you are updating from 0.2.x
On first start Keylight copies your progress, settings and imported songs to the new location. Your old data is left untouched. To be safe, make a backup first under Settings > Progress.
Licences
Keylight is MIT licensed. Third-party music and samples are listed in THIRD_PARTY_NOTICES.md. Keylight is an unofficial community project and is not affiliated with or endorsed by ROLI.
Keylight 0.2.4: only the next keys light up, more exercises, note games
Keylight for Mac and Windows (beta). iOS and Android are coming soon.
Downloads
Keylight-0.2.4-mac.zip: Apple Silicon Mac, macOS 13 or newerKeylight-0.2.4-win-x64.zip: 64-bit Windows 10 or 11 (beta)
New in 0.2.4
- Only the next keys light up. Without blocksd (always the case on Windows), every key used to stay lit in the keyboard's own colours, so you couldn't tell which one to play. Now the keyboard's colours go out while Keylight runs: the note to play is bright, the next one is dimmed, and keys you hold light up too. Thanks to the tester who reported this!
- Light styles work without blocksd. Piano, Pro, Stage and User now change the key colours, as close as the keyboard's built-in colours allow.
- More exercises, in all 12 keys: natural and harmonic minor scales, five-finger patterns, major and minor arpeggios, and I–IV–V–I chords.
- Three note games: Find the Key, Read the Treble and Read the Bass, one minute each. Any octave counts, and the right key lights up if you're stuck.
Please test the lights. These changes have only run against a simulated keyboard so far, so please say how they behave in an issue, especially whether the next key looks dimmer. When Keylight closes, the keyboard goes back to its rainbow mode, so a mode you set elsewhere has to be set again. If it ever crashes and the keys stay dark, change the mode in your keyboard's software or restart the keyboard.
Two chained Piano Ms have now been confirmed working on real keyboards, thanks to a tester.
Install on Mac
- Unzip, then clear the download quarantine once in Terminal:
xattr -dr com.apple.quarantine ~/Downloads/Keylight-0.2.4/Keylight.app - Move
Keylight.appto Applications, install blocksd for the key lights (see the README), plug in the keyboard and open it.
Install on Windows
- Right-click the zip, choose Extract All, then open
Keylight\Keylight.exe. - Windows SmartScreen will warn because the app isn't signed yet: click More info, then Run anyway.
- Plug the keyboard in over USB. Close other apps that use it (ROLI Connect, a DAW) so Keylight can open it.
Found a bug or have an idea? Open an issue. Keylight is free; if it helps you, you can support it on Ko-fi.
Keylight 0.2.3: sheet music, two keyboards as one (beta)
Keylight for Mac and Windows (beta). iOS and Android are coming soon.
Downloads
Keylight-0.2.3-mac.zip: Apple Silicon Mac, macOS 13 or newerKeylight-0.2.3-win-x64.zip: 64-bit Windows 10 or 11 (beta)
New in 0.2.3
- Sheet music. Press Sheet in the player to show the score above the falling notes. It slides under a playhead and stays in time at any speed, in Wait mode, in loops and through repeats. All the built-in songs and any MusicXML you import have it; MIDI files and MP3s don't. MusicXML songs you added before this version need adding again.
- Two keyboards as one (beta). Two 24-key keyboards play as 48 keys, on two USB cables or joined with the magnetic connector. It has only been tested with simulated keyboards so far, so please report how it goes in an issue. See the README for how to set it up.
- Automatic no longer guesses. With several MIDI inputs that don't say what they are, it asks you to choose your keyboard, and it now skips simulator ports.
- The log no longer repeats the light service's status every 2 seconds.
- The Add a song sheet and the README now say to only add music you have the right to use, and where cover art and lyrics come from. The 49-key notes in the README are up to date with a tester's results on the real keyboard: thank you!
Install on Mac
- Unzip, then clear the download quarantine once in Terminal:
xattr -dr com.apple.quarantine ~/Downloads/Keylight-0.2.3/Keylight.app - Move
Keylight.appto Applications, install blocksd for the key lights (see the README), plug in the keyboard and open it.
Install on Windows
- Right-click the zip, choose Extract All, then open
Keylight\Keylight.exe. - Windows SmartScreen will warn because the app isn't signed yet: click More info, then Run anyway.
- Plug the keyboard in over USB. Close other apps that use it (ROLI Connect, a DAW) so Keylight can open it.
Found a bug or have an idea? Open an issue. Keylight is free; if it helps you, you can support it on Ko-fi.
Keylight 0.2.2: the 49-key ROLI Piano (beta), choose your keyboard
Keylight for Mac and Windows (beta). iOS and Android are coming soon.
Downloads
Keylight-0.2.2-mac.zip: Apple Silicon Mac, macOS 13 or newerKeylight-0.2.2-win-x64.zip: 64-bit Windows 10 or 11 (beta)
New in 0.2.2
- The 49-key ROLI Piano (beta). The screen shows all 49 keys, setup finishes on them, and playing both ends no longer makes the screen jump. Built from an r/ROLI tester's report and measurements, thank you. It has only been tested with simulated key presses so far, and whether this keyboard lights up from Keylight is not confirmed yet, so please say how it goes in an issue. See the README for details.
- Choose your keyboard. Settings and setup now list every MIDI input. Keylight remembers your choice, and shows it as "(not connected)" while it's unplugged rather than switching to something else. Automatic also skips more loopback ports.
- If you switch input while holding a key or the pedal, they now let go instead of ringing on.
- The Add a song sheet now says accurately that your file is never uploaded, since the cover and lyrics lookup does go online. You can switch the lookup off there.
The 24-key Piano M and LUMI Keys should play just as before, apart from the new keyboard list in Settings. If anything changed for you, please say so in an issue.
Install on Mac
- Unzip, then clear the download quarantine once in Terminal:
xattr -dr com.apple.quarantine ~/Downloads/Keylight-0.2.2/Keylight.app - Move
Keylight.appto Applications, install blocksd for the key lights (see the README), plug in the keyboard and open it.
Install on Windows
- Right-click the zip, choose Extract All, then open
Keylight\Keylight.exe. - Windows SmartScreen will warn because the app isn't signed yet: click More info, then Run anyway.
- Plug the keyboard in over USB. Close other apps that use it (ROLI Connect, a DAW) so Keylight can open it.
Found a bug or have an idea? Open an issue. Keylight is free; if it helps you, you can support it on Ko-fi.
Keylight 0.2.1: Mac and Windows (beta)
Keylight for Mac and now Windows (beta). iOS and Android are coming soon.
Downloads
Keylight-0.2.1-mac.zip: Apple Silicon Mac, macOS 13 or newerKeylight-0.2.1-win-x64.zip: 64-bit Windows 10 or 11 (beta)
New in 0.2.1
- Windows (beta). The keys light up in the keyboard's own colours over MIDI, with no extra software. The four light styles, the brightness slider, the arrow and mode buttons and the battery level need blocksd, which doesn't run on Windows yet, so they are Mac-only for now. It passes the full self-test on Windows, but nobody has tried it with a real keyboard on Windows yet: please report how it goes.
- Drop in any MP3 and learn it: notes, cover art and scrolling synced lyrics (this was already in 0.2.0; it's now front and centre in the README).
- A Ko-fi link for anyone who wants to support the project.
Install on Mac
- Unzip, then clear the download quarantine once in Terminal:
xattr -dr com.apple.quarantine ~/Downloads/Keylight-0.2.1/Keylight.app - Move
Keylight.appto Applications, install blocksd for the key lights (see the README), plug in the keyboard and open Keylight.
Install on Windows
- Right-click the zip, choose Extract All, then open
Keylight\Keylight.exe. - Windows SmartScreen will warn because the app isn't signed yet: click More info, then Run anyway.
- Plug the keyboard in over USB. Close other apps that use it (ROLI Connect, a DAW) so Keylight can open it.
Found a bug or have an idea? Open an issue. Keylight is free; if it helps you, you can support it on Ko-fi.
Keylight 0.2.0
The first public release of Keylight, an unofficial, open-source piano-learning app for the ROLI Piano M and LUMI Keys.
Download: Keylight-0.2.0-mac.zip below (Apple Silicon Mac, macOS 13 or newer).
Install
- Unzip it. You get a
Keylight-0.2.0folder withKeylight.appand a copy of these steps. - Keylight is not notarised by Apple yet, so clear the download quarantine once in Terminal:
xattr -dr com.apple.quarantine ~/Downloads/Keylight-0.2.0/Keylight.app - Move
Keylight.appto Applications. - Install blocksd for the key lights (see the README's Install section; Keylight starts it for you).
- Plug the keyboard in over USB, switch it on, and open Keylight.
What's in it: a 3D falling-notes player plus Rainbow, Colornote and Classic views, key lights in four styles, Wait mode, 0.5x / 0.75x / full speed, left/right/both hands, 19 songs, 5 lessons, Scales & Chords, a Playground with live chord names, 4 games, MIDI / MusicXML / audio import, 8 instruments, and a hand-tracking beta.
Found a bug or have an idea? Open an issue.