A system for typing English words on a piano.
This was something I originally made back in May of 2018 just as a quick project. I spent about 6 hours designing and implementing the core system. After that, I thought it would be funny to get really fast at the system, so I made some minor improvements and practiced for hours. I eventually got to about 72 WPM and shared some videos around April Fool's Day, 2019:
- Here's an overview video talking about the design and showing off a typing test
- Here's the April Fool's Day video where I live-streamed typing tests with proper capitalization and punctuation
- Here's the original design document
As mentioned earlier, there was a design document behind all of this, but I'll sum up the high-level design here:
- English-optimized: this system is not meant for coding or for non-English languages. The layout of the piano is based on letter frequencies in English.
- Speed-optimized: this system is designed for typing speed over musicality.
- "Shift" key: in order to input any special commands like changing modes or using intervals, you would hold a "shift" key on the piano (F2 by default in the code).
- Modal typing: you can play a major, minor, or augmented chord anywhere on the keyboard to change modes. That would switch between typing letters, commands, or numbers.
- Velocity-sensitive typing: typically, pressing a key harder will act as though you'd held shift on the computer keyboard, so
1
becomes!
anda
becomesA
. There are some exceptions, e.g. a/
becoming a\
orbackspace
becomingctrl+backspace
. - Interval keys: some punctuation and special commands can be invoked via holding the "shift" key and pressing an interval anywhere on the keyboard. For example, a perfect fourth will input a comma.
- Dedicated keys for space and backspace: you press these more frequently than almost anything else, so they get their own keys in addition to having intervals assigned.
- Non-steno: I assume it's pretty easy to map stenotyping to a piano, so I specifically did not want to pursue that for the design since I wanted to explore the problem space myself.
Because of how little time I spent coding this, there are many pieces of the code that could be much better. I'd also intended on having UI and overlays to make it easier to learn the system, but I never got around to doing that.
- Make sure you have Node and Yarn installed
- If on Windows, make sure to check the box that says "Automatically install the necessary tools. Note that this will also install Chocolatey. The script will pop-up in a new window after the installation completes." If you don't do this, then you'll also need to install Python, Git, and either Visual Studio or just the C++ build tools for
node-gyp
to work.
- If on Windows, make sure to check the box that says "Automatically install the necessary tools. Note that this will also install Chocolatey. The script will pop-up in a new window after the installation completes." If you don't do this, then you'll also need to install Python, Git, and either Visual Studio or just the C++ build tools for
- Clone this repo
- If you're on Linux, do these steps:
sudo apt install libasound2-dev
- Make sure you have gcc and Python.
- For robotjs, I needed these dependencies
sudo apt-get install libxtst-dev libpng++-dev
- For Electron, I hit this issue and needed to run this command too:
sudo apt install libgconf-2.4
- From the root directory...
- Run
yarn
. If you get an error on Linux about npm being "npm-6.5.0-next" or something and not passing the semver check, just go into the script that is complaining about it and delete the asserts. cd app
yarn
cd ..
- Run with
yarn dev
- If it doesn't detect your MIDI device, you'll likely need to modify
midiwrapper.js
'sportToGet
; I didn't write any smart code around selecting a device or ensuring that it works.
After the program starts, you should just be able to type on your MIDI keyboard and have English letters pop out. Put your pinky fingers on the L and the H of Letter Mode for the optimal setup.
Special keys:
- Low F#: space
- High A: backspace
Colors:
- Red: low-velocity press
- Pink: high-velocity press
Commands:
Number in picture | Low-velocity press | High-velocity press |
---|---|---|
1 | Up arrow | Up arrow |
2 | Down arrow | Down arrow |
3 | Home | Delete to beginning of line |
4 | Go back by word | Delete last word |
5 | Left arrow | Backspace |
6 | Right arrow | Delete |
7 | Go forward by word | Delete next word |
8 | End | Delete to end of line |
9 | Undo | Undo |
10 | Redo | Redo |
The "shift" key mapped to the lowest F in the picture is how you'll use intervals and modes. You have to hold F before any of the following chords or intervals:
- Chords
- Any major chord (e.g. C-E-G): change to Letter Mode.
- Any minor chord (e.g. C-Eā-G): change to Command Mode.
- Any augmented chord (e.g. C-E-G#): change to Number Mode.
- Intervals
- Minor or major second: space
- Minor or major third: enter
- Perfect fourth: comma + space
- Tritone: backspace
- Perfect fifth: period + space
- Minor sixth: hyphen
- Major sixth: apostrophe
- Minor seventh: question mark + space
- Major seventh: exclamation mark + space
- Perfect octave: backspace previous word
- Major ninth: temporarily enter Number Mode for a single keypress (e.g. if you want to type a single "@" symbol or something)
There are no sound files included in this repo. If you want sounds to play, then the easiest thing to do is to connect a MIDI cable to your MIDI device and run it to a system that can play sounds. I know this seems like a cop-out, but that was my setup, so that's all I was trying to support.
I'm including some problems/solutions that I ran into while testing everything, but this was back in 2018 or 2019, so it may not be relevant anymore.
For me, Yarn wasn't using the right registry, so I had to use NPM.
Try running these commands:
npm config set registry https://registry.npmjs.org/
cd app
npm install --save midi
..\node_modules\.bin\electron-rebuild.cmd
This was a problem on Windows where I would get an error like this:
c:\users\agd13_000\.node-gyp\10.15.0\include\node\v8.h(2570): error C2144: syntax error : 'int' should be preceded by ';' (..\src\node-midi.cpp) [B:\Code\JavaScript\keyiano\app\node_modules\midi\build\midi.vcxproj]
I opened the .sln
and .vcxproj
files in Visual Studio Express 2013 to figure out what line was wrong:
static constexpr int kMaxLength =
sizeof(void*) == 4 ? (1 << 28) - 16 : (1 << 30) - 1 - 24;
Turns out VSE2013 doesn't know about certain C++11 features like constexpr
. I downloaded Visual Studio 2017 Community. It was roughly a 6GB download and took maybe 8 minutes to download/install (and then I had to restart). After the restart, I did yarn add midi
in the app
folder and it all worked.
Can't send unshifted characters via robot
(reference)
If you find robot.typeString("!");
not working, try robot.keyTap("1", "shift");
instead.
Keep in mind that if you go this route, the modifier is REQUIRED, so if you just want to type a "1", then you need to do robot.keyTap("1", "none");
.
Just open ./app/mainprocess_src/midiwrapper.js
and try changing the MIDI port to use from 0 to something else. Eventually, it will say "Novation Impulse" or whatever the device is that you're using.
If Device Manager doesn't show your MIDI controller under "Other devices", try a different USB port.