Getting Started

Welcome to the Serenade guide! Let’s get started.

Installation

Register for a Serenade account here. Then, follow the instructions on that page to install Serenade.

Hello, Serenade

Let’s write a few lines of code with voice. When dictating voice commands, speak as you normally would in a conversation. Over-enunciating words or letters can actually make it harder for Serenade to understand you, so just try to talk naturally (even in cases where Serenade didn’t hear you correctly the first time). You can also pause while speaking, and Serenade will wait for you; there’s no need to try to say an entire command in one breath.

As you speak, you’ll see alternatives appear on the side of your screen. To select an alternative to run, say:

use one

Where one is the number of the row you’d like to select. When Serenade is confident in what you said, your command will be executed automatically, without you needing to say use.

If none of the alternatives are right and you’d like to start over, just say:

clear

Let’s get started. First, press the Listen button. Create a new tab by saying:

new tab

Then, save the empty file by saying:

save

You should see a standard save dialog. Create a file called hello.py and click Save.

Now, let’s write some Python. Try saying:

add import random

Then, select the appropriate alternative by saying use one, use two, etc. You should see the below code added to the editor:

import random

If you accidentally select the wrong alternative, you can go back by saying:

undo

Next, create a function by saying:

add function get random

Specify a use command to select an alternative, and then you should see:

import random

def get_random():
    pass

You can add a parameter called number to your function by saying:

add parameter number

After you say a use command, you should see:

import random

def get_random(number):
    pass

Let’s give the function a body. try saying:

add return four

After saying a use command, you should have the code:

import random

def get_random(number):
    return 4

You can move around the cursor with commands like:

up
down
left
right
next line
previous word
line one

For instance, try saying:

line one

Now, your cursor should be back on the first line of the file. To delete that line, you can say:

delete line

Now, the import statement you added earlier should be removed.

That’s it for our hello world! To learn more about how to use Serenade, head to the next section, Basic Usage.