Now that you have the background stuff out of the way, let’s start up VoiceCode!

Open a terminal and navigate to the VoiceCode directory, then run the start up command:

cd ~/voicecode
./run.sh

You should see a system alert that says: please check your VoiceCode license key

To fix this, open the following file or create it if it does not exist:

~/voicecode/commando/config/settings.json

And paste in your VoiceCode license number where it currently says “xxx”. Paste in your registered email address where it says “[email protected]” If you have not received your VoiceCode license number, you will receive it within 24 hours of your purchase. (right now license key generation is not automated, so I have to manually send it to you. This will be automated in the future)

If you are creating this file, make sure to also add all the settings as follows:

{
  "license": "XXXXXXXXXXXXXX",
  "email": "[email protected]",
  "public": {
  	"port": 5000
  }
}

Then, save the file and voicecode should automatically start correctly this time.

Currently, voicecode requires you to be connected to the Internet when it starts up so that it can check the license key. Off-line support will be added soon.

If you are offline when you start up VoiceCode, you will get the same error as if you had an invalid license key. Once you connect to the Internet, navigate to the terminal where you ran the VoiceCode start up command from, and press “ctrl c”, then run the startup command again and it should work. you should get a system notification saying “voicecode is running!”

There are some significant differences between "Dragon Dictate" (version 4) and "Dragon" (version 5). So VoiceCode needs to know which one you are using. Currently, by default it assumes version 4. If you are using version 5, set the following setting in ~/voicecode/commando/config/user_settings.coffee:

Settings.dragonVersion = 5

And then save the file before starting VoiceCode.