Aldebaran documentation What's new in NAOqi 2.4.3?

Choregraphe suite - Installation Guide

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 14.04 (Trusty Tahr) and later
Windows Microsoft Windows 7 and 8.1
Mac Mac OS X 10.10.2 Yosemite

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: Downloading & Installing Aldebaran 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 or Accessing Pepper Web page using Pepper’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>