Install ESP-IDF Extension for ESP32 on VS Code (Windows, Mac OS X, Linux)

Learn how to install the ESP-IDF extension for ESP32 boards on VS Code IDE (Microsoft Visual Studio Code) on Windows, Mac OS X or Linux Ubuntu operating systems.

Introduction to ESP-IDF (Espressif IoT Development Framework)

ESP-IDF, Espressif IoT Development Framework, is the original framework developed by Espressif (the developer of ESP32 chips) to program the ESP32. It is an SDK to develop applications for ESP332 chips using C and C++ programming languages that gives you low-level access to the hardware.

Being the “official” way to program the ESP32, it means the SDK is frequently updated to support the release of newer versions of ESP32 chips. On the other hand, it may take a while for new chips to be supported in the Arduino IDE. The following table shows the current supported ESP32 SoC series by ESP-IDF:

• ESP32
• ESP32-S2, ESP32-S3
• ESP32-C2, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-C61
• ESP32-H2
• ESP32-P4

In order to program the ESP32 board using ESP-IDF, we recommend using VS Code IDE with the ESP-IDF extension and that’s what you are going to install on this guide.

Installing VS Code IDE

Follow the next instructions to install VS Code on your Operating System:

• A) Windows
• B) MacOS X
• C) Linux

A) Installing VS Code on Windows (Visual Studio Code)

Go to code.visualstudio.com and download the stable build for your operating system (Windows).

Click on the installation wizard to start the installation and follow all the steps to complete the installation. Accept the agreement and press the Next button.

Select the following options and click Next.

Press the Install button.

Finally, click Finish to finish the installation.

Open VS Code, and you’ll be greeted by a Welcome tab with the released notes of the newest version.

That’s it. Visual Studio Code was successfully installed.

B) Installing VS Code on Mac OS X (Visual Studio Code)

Go to code.visualstudio.com and download the stable build for your operating system (Mac OS X).

After downloading the Visual Studio Code application file, you’ll be prompted with the following message. Press the “Open” button.

Or open your Downloads folder and open Visual Studio Code.

After that, you’ll be greeted by a Welcome tab with the released notes of the newest version.

That’s it. Visual Studio Code was successfully installed.

C) Installing VS Code on Linux Ubuntu (Visual Studio Code)

Go to code.visualstudio.com and download the stable build for your operating system (Linux Ubuntu).

Save the installation file:

To install it, open a Terminal window, navigate to your Downloads folder and run the following command to install VS Code.

$ cd Downloads
~/Downloads $ sudo apt install ./code_1.49.1-1600299189_amd64.deb

When the installation is finished, VS Code should be available in your applications menu.

Open VS Code, and you’ll be greeted by a Welcome tab with the released notes of the newest version.

That’s it. Visual Studio Code was successfully installed.

Installing Python

To program the ESP32 with ESP-IDF, you need Python 3.5 or a later version installed on your computer. Follow the instructions according to your operating system:

• A) Installing Python on Windows
• B) Installing Python on Mac OS X
• C) Installing Python on Ubuntu Linux

A) Installing Python on Windows

Go to python.org/downloads and download Python 3.13.3 or a later version.

Open the downloaded file to start the Python installation wizard. The following windows show up.

Important: make sure you check the option Add Python to PATH. Then, you can click on the Install Now button. You may also need to check the “Use admin privileges when installing py.exe”.

If the installation is successful, you’ll get the following message.

Finally, click the Close button.

B) Installing Python on Mac OS X

Open a Terminal window. You can open it through Spotlight Search. To launch Spotlight, click the small magnifying glass icon in your menu bar (or press Cmd+Space).

Then, type “terminal” and click on the Terminal icon to launch it.

To install Python, I’ll be using Homebrew.  If you don’t have the brew command available, type the next command in the Terminal window:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Here’s how it looks on the Terminal window:

Then, run the brew command to install Python 3.13:

brew install python3

Here’s how it looks on the Terminal window:

C) Installing Python on Linux Ubuntu

To program the ESP32 boards with ESP-IDF, you need Python 3.5 or a later version installed on your computer.

Open the Terminal window and check that you already have Python 3 installed. Run the following command:

python3 --version

It should return the current installed version:

python 3.13.3

If you don’t have Python installed, run the next command to install it:

sudo apt install python3

Whether you already have Python installed or not, you need to run the following command to install Python utilities.

sudo apt install python3-distutils

Installing the ESP-IDF Extension for VS Code

To access the ESP-IDF tools, you need to install the official ESP-IDF extension on VS Code. Open VS Code and click the Extensions icon in the left sidebar or click Ctrl+Shift+X to open the Extensions tab.

Search for “ESP-IDF“, select the ESP-IDF by Espressif Systems and click the Install button.

Press the “Trust Publisher & Install” button. The installation will take some time to complete.

That’s it! The ESP-IDF extension by Espressif Systems is now installed in your IDE, the following welcome screen should appear.

Next, follow these instructions to configure the ESP-IDF Extension:

1. Open the ESP-IDF Espressif extension panel
2. Expand the “Advanced” menu
3. Click the “Configure ESP-IDF Extension” option
4. Choose the “EXPRESS” setup mode to configure the ESP-IDF Tools

During the ESP-IDF Express Setup screen, you’ll be prompted to select the ESP-IDF version. At the time of writing this guide, the latest released version is v5.4.1. We recommend using version 5.X to follow along. Press the “Install” button.

Note: you can leave all other default options or change the ESP-IDF directory if you need to.

That’s it, you’ll see a similar screen while the ESP-IDF extension is being configured. Wait a few minutes until this process is completed.

Installing the C/C++ Extensions for VS Code (optional)

This step is optional, but since you’ll be using the C++ language with the ESP-IDF framework to program the ESP32 boards, we recommend installing these C/C++ extensions for VS Code. Open VS Code and click on the Extensions icon to open the Extensions tab.

Search for “C/C++“, select the first option and click the Install button.

You can also install the “C/C++ Extension Pack“.

Programming ESP32 with ESP-IDF using VS Code

That’s it, your ESP-IDF extension has been installed. You can get started programming your ESP32 boards with your first Blink project by following our guide ESP-IDF: ESP32 Blink LED Example.

Wrapping Up

In this tutorial, you learned how to install the ESP-IDF extension on VS Code. You can now program your ESP32 board using ESP-IDF.

Here are some ESP-IDF tutorials that you may find helpful:

• Programming ESP32 with ESP-IDF using VS Code – Getting Started Guide
• ESP-IDF: ESP32 Blink LED Example (VS Code)
• ESP-IDF: ESP32 GPIO – Control Digital Outputs

You can check our ESP32 resources (with Arduino IDE) to learn more about the ESP32 board:

• Learn ESP32 with Arduino IDE (eBook)
• More ESP32 Projects and Tutorials…

Thanks for reading.