macOS installation

Installation Procedure

Install Homebrew

Follow the installation instructions from there: https://brew.sh Note: When installing Brew, the XCode Command Line Tools are also installed.

And then install the following packages:

brew install cmake swig wget

Clone the Github Repository

From a Terminal app, create the development directory in your home directory and clone the repository:

cd
mkdir develop
cd develop
git clone https://github.com/omichel/webots.git
cd webots
git submodule init
git submodule update

Environment variables

It is convenient to add the following environment variables into your ~/.bash_profile file:

export WEBOTS_HOME=$HOME/develop/webots/webots      # Defines the path to Webots home.
export WEBOTS_ALLOW_MODIFY_INSTALLATION=1           # If defined, you are allowed to modify files in the Webots home using Webots.
export WEBOTS_DISABLE_SAVE_PERSPECTIVE_ON_CLOSE=1   # If defined, Webots will not save perspective changes when closed.
export WEBOTS_DISABLE_WORLD_LOADING_DIALOG=1        # If defined, the lodaing world progress dialog will never be displayed.

To make the changes available close and reopen your Terminal.

Install ffmpeg

Download the latest build from http://www.evermeet.cx/ffmpeg/ (for example ffmpeg-3.4.1.7z). Extract it, and put the extracted binary (ffmpeg) into ~/develop/webots/webots/util/.

Build Webots

You are know ready to compile Webots and all the required resources. The first time you compile Webots some dependencies will be automatically downloaded and installed in the Webots development environment.

make release -jX  # X is the number of cores.

In addition to the default release target, the following targets are also available:

• debug: Compiles with debugging symbols.
• profile: Compiles with debugging and profiling symbols (required to run GNU gprof for example).
• distrib: Compiles Webots in release mode and then create the distribution package.
• clean: Clean the compilation outputs.
• cleanse: Deep clean (some additional files such as dependencies are removed too).

Optional Installations

Install Python 3.6

To use the Python API you will need to install the latest version of Python 3.6 from https://www.python.org

Install Java

To use the JAVA API you will need to install the Java SE Development Kit 1.8.92 for Mac OS X from: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Create a Webots.app bundle

In order to launch Webots directly from Finder you could create a Webots.app directory with symbolic links to the Webots local repository content as following:

cd ~/develop
mkdir Webots.app
cd Webots.app/
ln -s ${WEBOTS_HOME}/Contents Contents
ln -s ${WEBOTS_HOME}/resources resources
ln -s ${WEBOTS_HOME}/lib lib
ln -s ${WEBOTS_HOME}/bin bin
ln -s ${WEBOTS_HOME}/change_logs change_logs
ln -s ${WEBOTS_HOME}/doc doc
ln -s ${WEBOTS_HOME}/include include
ln -s ${WEBOTS_HOME}/projects projects
ln -s ${WEBOTS_HOME}/util util

You can now launch Webots.app from the Finder by double-clicking on it.