Information

• The installer was tested on MacOS Sonoma 14.0, Sequoia 15.0 and Tahoe 26.0;
• If you are using custom zsh configurations, it is advised to temporarily turn them off for the purpose of the installation. To do this, open the .zshrc file in a text editor (located in /Users/username/) and comment out the export ZSH="$HOME/.custom_zsh_name" line.

👉 Launching the installer

• download the .zip of the setup program: https://github.com/EPFL-MICRO-315/Create_VSCode_e-puck2/archive/refs/tags/RefTag.zip
• extract the .zip if necessary
• launch a terminal under Create_VSCode_e-puck2-RefTag
• launch the install script with ./macos.sh install. The script will tell you what will be installed and which new directories are created. Please respond to the message asking if you agree to continue.

A graphical installer should appear. Click on Next >

👉 Graphical Installer

1. set the install path and workplace path

   • ⚠ no spaces are allowed in the paths
   • by default, the install path is under /Users/username/Applications/
   • by default, the workplace path is under /Users/username/Documents/

2. change advanced installer settings

   • ⚠ ADVANCED users only
   • ⚠ do not change unless you know what you are doing

3. proceed with the installation

4. wait for the installation to complete (we suggest you to grab a cup of coffee ☕ / maté 🧉)

   • ⚠ Look out for any error (warnings can be ignored)
   • ⚠ Keep an eye on the terminal as it is likely to ask for a session password

5. Once the progress bar is completed, you can clikc on Finish. Congratulations ! The IDE VSCode EPuck2 has been successfully installed 🥇

6. If needed, reactivate your custom zsh configuration in the .zshrc file

💡 Further readings

• IDE - Tools