SoftBank Robotics documentation What's new in NAOqi 2.8?

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.12 Sierra

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: access_bonjour_nao or access_bonjour_pepper.

Linux only

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

In this case, use:

./choregraphe --no-ogre

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>


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


$ sudo open --args --mode unattended --installdir <destination_directory>