Getting Started

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


  1. Download and install Atom.

  2. Download and install the Serenade Atom plugin.

  3. Sign up for Serenade.

  4. Copy your Serenade token, and paste your token into the Serenade plugin, shown below.

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).

To start, press the Listen button. Create a new tab by saying:

new tab

As you’d guess, this opens up a new editor tab. Now, save the file by saying:


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

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

add value equals two plus two

On the right side of the screen, you should see something that looks like this:


You might see multiple rows in this list if Serenade isn’t sure what you said. Each row represents an option for a command you can execute. To select one of the options, say use followed by the corresponding number on the left. So, if the first row is correct, say:

use one

Then, you should see the below code added to the editor:

value = 2 + 2

If at any time you’d like to start over (e.g., if Serenade didn’t hear you correctly), you can just say:


Or, if you select the wrong row, you can go back by saying:


Let’s add another line by saying:

add import random

Now, specify which option you’d like to use, and you should see:

import random

Now, you can say:

go to line 1

To move your cursor back to the first line. Finally, to delete that line, you can say:

delete line

Now, the first statement you added should be removed.

At this point, you’ve had a brief overview of Serenade. To learn more about how to use Serenade, head to Basic Usage.