What is a Project

The Project allows you to save on your computer, in one folder, all the files and content necessary to create an Application:

How to manage Project

The File menu allows you to:

  • Create, open and save a Project;
  • Import a Project from a CRG or a former Directory,
  • Add or import new content to the current Project,
  • Modify its Project Properties,
  • Export the project as a CRG,
  • Build it into an Application.

The Project content panel allows you to:

  • Modify its Project Properties,
  • Add new content to the current Project,
  • Edit, delete and organize in sub-folders the content and files attached to the current Project.

Tips: external management

You can also modify the content of the Project using your favorite file management tools.

For example, to import a Dialog topic from a Project to another:

Step Action
Copy/Paste the folder containing the Dialog topic from one Project folder to another.

Coming back to Choregraphe, accept the imported files.



If you pressed No or No to All, this is not final. You still can import your files manually into your project.

You just have to select Import content > Files... or Import content > Folder... from the File menu, browse into your project folder, and import the desired files or folder.

Project available formats

Extension Usage

Storage format

A unique file with PML extension located at the root folder of your project references all the Project files and contents.


Publication format

The Package is a binary format used to publish an Application on the Apps 2.1 Store.

For further details, see: Building an Application Package.


Exchange Format

The CRG file format stores the project in a single compressed file.

The project CRG format is an easy way to archive a project and / or deliver it to someone else.

Porting a 1.14 Project

1. Importing 1.14 projects files

To import a Project created with a former version of Choregraphe:


Step Action

Choose File > Import project from CRG file...

Browse to select the file to import.
Optionally, modify the Project name and/or its path.
Click the OK button.

Project directory

Step Action

Choose File > Import project from former project directory...

Browse to select the file to import.
Optionally, modify the Project name and/or its path.
Click the OK button.

2. Cleaning a 1.14 Project

Once imported, your 1.14 Project needs to take advantage of the new features:

Check your Python code

Track deprecated APIs:

  • The main evolution impacted ALMotion: “walk” becomes “move” in order to support all the Aldebaran robots.

  • To see the whole list of deprecated methods and events, see:

    NAOqi API & SDks 2.1 Release note.

    Tip: CTRL+F on the page allows you to search for ‘deprecated’ key word, so you can focus on the cleaning before discovering all the new features.

Cut/replace the deprecated boxes

See the full list of boxes to upgrade in the Choregraphe Release Note: Improved boxes.

3. To support the new Aldebaran Cloud

Check the Properties

Note that the Project has now properties allowing you to edit directly the manifest of your Application.

Pay attention to the unique Application ID, automatically generated by Choregraphe. If needed, this Application ID can be changed.

For further details, see: Project Properties.

4. To support the new NAO V5

Most of the dances created with version 1.14.5 still run on NAO V4 and even on V5.

But, as the masses slightly evolved, balance breakpoints has also changed.

So for example, if your NAO stands on one foot, or strikes a pose at the limit of its possibilities (in terms of balance), then a NAO V5 may fall.

Check tune your dances and extreme motions

Step Action
Make sure you have cut/replaced all the deprecated boxes listed here: Improved boxes.
Test your Timelines using NAO V5 Simulated robots.

If your animation fails on V5, you can: