Install Cicada for MacOS

1. Download the Cicada App Installer.

2. Unzip and open the downloaded folder ‘cicada-app-installers-master’.

3. Open the ‘install-cicada-x.x.x_MacOs’ App by holding Control while you click on the file, and select ‘Open’.

4. The warning above may appear, but don’t worry, click ‘Open’.

5. You may be prompted with the request to allow Java to make changes to your system. Enter your username and password for the Admin User on your Mac.

5. Follow the installation process by clicking ‘Next >’.

6. It is highly recommended to use the default installation folders.

7. In the confirmation screen you can see where Cicada will be installed as well as a Matlab Runtime software. Matlab Runtime is a free software that enables the execution of compiled Matlab applications.

8. Click ‘Install >’ to confirm and begin the installation process.

9. If everything went well, the installer will show that the ‘installation completed successfully’.

Start Cicada

You can either run Cicada from the Terminal, or if you want to run Cicada simply by opening the Cicada.app from the Finder window, then we may need to tell your Mac where to find the Matlab Runtime Software.

Run Cicada from the Finder Window

1. Navigate to the Cicada installation folder, i.e. ‘/Applications/Cicada/application’ and open ‘Cicada.app’.

2. If this does not work, this probably means that your Mac does not know where to find the Matlab Runtime Software. Follow the instructions below or open Cicada from the ‘Terminal’ app.

Run Cicada using the Terminal

1. Open the ‘Terminal’ app, which is located in ‘/Applications/Utilities/Terminal’.

2. Change directory to the Cicada installation location by typing,

$ cd /Applications/Cicada/application

3. Start Cicada by running the run_Cicada.sh script with the location of the Matlab Runtime Software as the first argument,

$ sh run_Cicada.sh /Applications/MATLAB/MATLAB_Runtime/v97

Locate the Matlab Runtime Software

We need to tell your Mac (just this once) where the Matlab Runtime Software is located. After we’ve done that, you can run Cicada directly from the Finder window.

1. Open the ‘Terminal’ app, which is located in ‘/Applications/Utilities/Terminal’.

2. Check whether the DYLD_LIBRARY_PATH environment variable is defined by typing

$ echo $DYLD_LIBRARY_PATH

3. If the result is empty, it is undefined and we’ll create that environment variable, otherwise it is defined and we’ll append that variable.

4. This environment variable should be stored in a hidden file called ‘.bash_profile’ in your home folder, i.e. ‘/Users/[your-username]/.bash_profile’. Use the Finder window to navigate to your home folder and use Command+Shift+Dot to toggle hidden files visible. If ‘.bash_profile’ does not exist yet, continue to step 5, otherwise continue to step 9.

5. Open the ‘TextEdit’ app, and create a new empty document.

6. Click ‘Format’ > ‘Make Plain Text’ if this is not already a plain-text document.

7. Click ‘File’ > ‘Save’, and type .bash_profile in the ‘Save As’ field, and Select your home folder (indicated by the house icon) as the location. Make sure to un-tick the option ‘if no extension is provided, use “.txt”’. Click ‘Save’.

8. The warning message above may appear, but that’s ok, click ‘Use “.”’

9. If the environment variable was

   • undefined, add this line to the ‘.bash_profile’ file

   export DYLD_LIBRARY_PATH=/Applications/MATLAB/MATLAB_Runtime/v97/runtime/maci64:/Applications/MATLAB/MATLAB_Runtime/v97/sys/os/maci64:/Applications/MATLAB/MATLAB_Runtime/v97/bin/maci64
   

   • defined, add this line to the ‘.bash_profile’ file

   export DYLD_LIBRARY_PATH=${DYLD_LIBRARY_PATH}:/Applications/MATLAB/MATLAB_Runtime/v97/runtime/maci64:/Applications/MATLAB/MATLAB_Runtime/v97/sys/os/maci64:/Applications/MATLAB/MATLAB_Runtime/v97/bin/maci64
   

10. Save the ‘.bash_profile’ file and restart your Mac.

11. Start Cicada. Once you have specified the location of the Matlab Runtime Software, you can simply start Cicada from the Finder by navigating to ‘/Applications/Cicada/application’ and open ‘Cicada.app’.