Updating to the new IDE

This material has been superseded. Visit learn.bela.io for the maintained version.

These are the instructions to update your old version of Bela to the new IDE to start enjoying all the new exciting features.

Note 1: If your board has a very old version of the Bela image, then you should most definitely flash a new image (which already contains the updated IDE) instead of following the procedure below. Follow the instructions here to do so.

Note 2: Before you start this process, make sure that all your projects are securely backed up somewhere. Updating the board should not affect your project folder, but better to be safe than sorry!

Note 3: Windows users will need a terminal emulator and a bash shell to run the script. Instructions on how to obtain these can be found here

The updating process consists on the following steps:

1. Plug in your Bela board to your computer via USB.

2. Download the latest version of the Bela repo from here: https://github.com/BelaPlatform/Bela/archive/master.zip

3. Unzip the archive and move it to a convenient folder on your computer.

4. Make sure that your board is plugged in and wait until it has finished booting.

5. In finder, navigate to the scripts folder inside the recently unzip repo and double click on update_board (update_board.sh on Windows machines).

6. A terminal window will open up, you will be asked to type Y followed by Enter.

7. After a couple of minutes the board will be updated and you are ready to start using the new IDE!

8. troubles updating? Write to us on the forum!