This project is not endorsed or sponsored by Artiphon, Inc in any way.

What?

This software enhances your improv music-making experience when using an Orba connected to a Windows PC over USB, by automatically configuring Orba's key based on a currently playing song.

When playing a song, you often need to change the key programmed into the Orba in order for your improv to sound good. This means determining the correct key, opening the Orba app, and then modifying the key through the app's user-interface.

Enter AutoKey.

Whenever a new song comes on, AutoKey will determine the key signature of the song using Spotify's Analysis API, and then reconfigure your Orba using a series of mouse movements and keystrokes.

The result is a much improved experience when playing and searching for your favorite songs, as you no longer need to worry about the Orba's key being incorrect (mostly - Spotify may not have the key, or it may be inaccurate.)

Prerequisites

Setting up AutoKey is pretty involved at the moment, but shouldn't be out of reach if you're familiar with using the command line & Python.

1. Windows

2. YouTube Music, YouTube, or Spotify

3. Firefox

4. AutoIt

   NOTE: the app assumes you've installed AutoIt at C:\Program Files (x86)\AutoIt3\AutoIt3.exe. If that's not the case, edit AUTOIT_PATH at the top of build.py.

5. Orba App v0.15.18

6. Python

7. Spotify Developer Account

Setup

0. Clone this repo or download the zip (green Code button to the top-right)

1. Check you have Python 3 installed, and that your system's PATH environment variable includes the path to Python (trying typing python in a command-prompt window).

   • Add dependency: python -m pip install spotipy (get pip)

2. Add environment variables for your Spotify credentials (needed to determine key of a song)

   1. Visit Spotify developer dashboard

   2. Create a new Spotify application, and take note of the Client ID and Client Secret

   3. Open PowerShell

   4. $Env:SPOTIPY_CLIENT_ID = "your_client_id"

   5. $Env:SPOTIPY_CLIENT_SECRET = "your_client_secret"

      NOTE: spotipy is not a typo.

   6. Log out of Windows and back in again

3. In PowerShell, run python build.py

4. In PowerShell, run python check_config_win.py to make sure everything is setup correctly:

   • It should show Looks good! Give it a try from Firefox..

5. Open the Orba app! Almost there!

6. Open src/app/orba_autokey.au3 and follow the instructions to calibrate the app

Try it out!

1. Install the Firefox extension

   1. Visit about:debugging
   2. Click This Firefox
   3. Click Load Temporary Add-on...
   4. Select src\add-on\manifest.json

2. You should see a new browser action icon in the toolbar

3. Visit one of the supported music streaming sites (Prerequisite 2)

4. Play a song

5. Watch your Orba auto tune itself to the correct key

6. If nothing happens, it may be because there is no key information for this song. Try another.

7. If still not working, check errors in a few places:

   1. On about:debugging, click Inspect on the extension
   2. Menu > Web Developer > Browser Console
   3. On the music player page, Right Click > Inspect > Console

Gotchas

If you have multiple music services open, each will be sending data to the app and you'll have some really annoying key changes. For now, only use with one streaming service open at once.

The YouTube support is pretty rudimentary; it just forwards the page title to the app. There's no support for grabbing the artist, so it'll be sending whatever you type in the search box, and then also when you click on a video.