28 lines (20 sloc) 1.25 KB

Installation instructions for Mac OS

  • Install latest Arduino IDE from

  • Open Terminal and execute the following command (copy->paste and hit enter):

    mkdir -p ~/Documents/Arduino/hardware/espressif && \
    cd ~/Documents/Arduino/hardware/espressif && \
    git clone esp32 && \
    cd esp32 && \
    git submodule update --init --recursive && \
    cd tools && \

    Where ~/Documents/Arduino represents your sketch book location as per "Arduino" > "Preferences" > "Sketchbook location" (in the IDE once started). Adjust the command above accordingly if necessary!  

  • If you get the error below. Install the command line dev tools with xcode-select --install and try the command above again:

    xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

    xcode-select --install

  • Try python3 instead of python if you get the error: IOError: [Errno socket error] [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol version (_ssl.c:590) when running python

  • Restart Arduino IDE