Piano Genie

Adaptation of the Piano Genie web demo for use in the I AM AI exhibition website.

Have fun playing piano like a virtuoso with the help of machine learning!

Use the 1-8 numbered keys on your keyboard (or the home row a-f and j-;) or touch the coloured blocks to play the piano. Use the space bar to control the sustain pedal.

The more you pretend you're a real player, the better the melody (and you!) will sound.

Configuration

The app can be configured through the config.json file in its root directory. Copy the config.sample.json file to config.json and modify its values as desired.

Keys supported are:

defaultLanguage (string, default: 'en'): Default language, indicated as an ISO two letter code.
showInfoButton (bool, default: true): If true shows an info button with instructions and credits
showConfigButton (bool, default: true): If true shows a button that opens the configuration dialogue.
showFullScreenButton (bool, default: true): If true, shows a button that puts the app in full screen.
showInputKeys (bool, default: true): If true, shows input keys.
showInputKeysText (bool, default: true): If true, shows text on the input keys indicating what keyboard keys to press. Set to false for touchscreen operation.
showInputInstructions (bool, default: true): If true, shows input instructions in the info screen. Set to false for touchscreen or dedicated input hardware.
keyCount (4 or 8, default: 8): Number of keys to show.
input (string, default: 'keyboard'): Input device. Can be 'keyboard', 'makey' for Makey Makey, or 'midi'. NOTE: Midi support is hacky and needs more work.
output (string, default: 'wave'): Output device. Can be 'wave' or 'midi'. NOTE: Midi support is hacky and needs more work.

Query string options

The following query string options are supported

embed: Add this query string if the app is run embedded in another page.

Compilation

This app is built using several compilable languages:

The HTML pages are built from pug template files.
The CSS stylesheet is pre-compiled from sass files.
The JS scripts are trans-compiled from es6 (ES2015) files.

To make any modifications re-compilation is necessary. You should install:

node and npm
yarn
gulp (install globally)

Afterwards run the following in the command line:

cd src
yarn

After it runs succesfuly you can compile as needed:

sass (stylesheets)
```
gulp styles
```
scripts (ES6)
```
gulp scripts
gulp dependencies
```

Either of these can be run separately.

pug (HTML pages)
```
gulp html
```
all
```
yarn run build
```
Watch and compile automatically on changes
```
gulp watch
```

Credits

Piano Genie was created by Chris Donahue, Ian Simon, Sander Dieleman and is part of the Google Magenta project.

This version is an adaptation by Eric Londaits (IMAGINARY gGmH), for use in the I AM AI exhibition website.

License

Audio samples based on SGM with modifications by John Nebauer.