Choregraphe suite installation

Choregraphe requirements


A computer connected to a WiFi access point, with:

  • 1.5 GHz CPU
  • 512 MB RAM
  • a certified OpenGL graphics card

Supported Operating Systems

OS Version
Linux Ubuntu 12.04 LTS (Precise) and later

Microsoft Windows XP Service Pack 3,

Microsoft Windows 7 and 8


Mac OS X version 10.7.1 Lion

Mac OS X version 10.8.3 Mountain Lion

Installing Choregraphe suite

Step Action

Make sure you have logged on:

  • as Administrator or
  • as a user with Administrator privileges (using sudo on Linux).

Retrieve the Choregraphe installer according to the Operating System of your computer:

  • choregraphe-suite-x.x-mac64-setup.dmg
  • choregraphe-suite-x.x-win32-setup.exe

You can download the latest release from Aldebaran Community website. For further details, see: Retrieving software.

Double-click the file to start the installation.

Linux only

Check you have execution permissions first, or run:

'sudo choregraphe-suite-x.x-linux{32,64}'
Accept the license agreement and follow the wizard steps.


Windows only

If not yet installed on your computer, the wizard installs also Bonjour, a tool conceived by Apple. For further details about Bonjour, see: Accessing NAO Web page using NAO’s name.

Linux only

You may experience problems with graphical acceleration if you do not have appropriate drivers.

In this case, use:

./choregraphe --no-ogre

Activating Choregraphe license

The first time you start Choregraphe, you will be prompted to enter a valid license key.

Deploying Choregraphe

To deploy Choregraphe on several computers, use the installer in command line with the following parameters:


$ sudo choregraphe-suite-x.x-linux{32,64} --mode unattended --installdir <destination_directory> --licenseKeyMode licenseKey --licenseKey <your_choregraphe_license_key>


$ choregraphe-suite-x.x-win32-setup.exe --mode unattended --installdir "<destination_directory>" --licenseKeyMode licenseKey --licenseKey <your_choregraphe_license_key>


$ sudo open --args --mode unattended --installdir <destination_directory> --licenseKeyMode licenseKey --licenseKey <your_choregraphe_license_key>