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 - 64bits only
Windows Microsoft Windows 7 and 8.1
Mac Mac OS X 10.11 El Capitan

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 SoftBank Robotics Community website. For further details, see: Downloading & Installing SoftBank Robotics 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>