![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/09\/ESP32-Install-ESP-IDF-Extension-VS-Code-Windows-Mac-OS-X-Linux.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nIntroduction to ESP-IDF (Espressif IoT Development Framework)<\/h2>\n\n\n\n
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.<\/p>\n\n\n
![\"What](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/what-you-need-program-ESP32-ESP-IDF.png?resize=486%2C352&quality=100&strip=all&ssl=1\")
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:<\/p>\n\n\n\n
- \n
- ESP32<\/li>\n\n\n\n
- ESP32-S2, ESP32-S3<\/li>\n\n\n\n
- ESP32-C2, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-C61<\/li>\n\n\n\n
- ESP32-H2<\/li>\n\n\n\n
- ESP32-P4<\/li>\n<\/ul>\n\n\n\n
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.<\/p>\n\n\n\n
Installing VS Code IDE<\/h2>\n\n\n\n
Follow the next instructions to install VS Code on your Operating System:<\/p>\n\n\n\n
- \n
- A) Windows<\/a><\/li>\n\n\n\n
- B) MacOS X<\/a><\/li>\n\n\n\n
- C) Linux<\/a><\/li>\n<\/ul>\n\n\n\n
A) Installing VS Code on Windows (Visual Studio Code)<\/h3>\n\n\n\n
Go to code.visualstudio.com<\/a> and download the stable build for your operating system (Windows).<\/p>\n\n\n
\n![\"Download](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/09\/Download-VS-Code.jpg?resize=750%2C569&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nClick on the installation wizard to start the installation and follow all the steps to complete the installation. Accept the agreement and press the Next <\/strong>button.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/2-Install-VS-Code.png?resize=598%2C464&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nSelect the following options and click Next<\/strong>.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/3-Install-VS-Code.png?resize=598%2C464&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nPress the Install <\/strong>button.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/4-Install-VS-Code.png?resize=598%2C464&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nFinally, click Finish <\/strong>to finish the installation.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/5-Install-VS-Code.png?resize=598%2C464&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOpen VS Code, and you\u2019ll be greeted by a Welcome tab with the released notes of the newest version.<\/p>\n\n\n
\n![\"VS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/09\/1-VS-Code-Welcome-screen.jpg?resize=750%2C558&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThat\u2019s it. Visual Studio Code was successfully installed.<\/p>\n\n\n\n
B) Installing VS Code on Mac OS X (Visual Studio Code)<\/h3>\n\n\n\n
Go to code.visualstudio.com<\/a> and download the stable build for your operating system (Mac OS X).<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/3-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-download-Mac-OS-X.png?resize=1167%2C592&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter downloading the Visual Studio Code application file, you’ll be prompted with the following message. Press the “Open<\/strong>” button.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/5-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-save-file.png?resize=487%2C158&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOr open your Downloads folder and open Visual Studio Code.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/4-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-file-downloaded-Mac-OS-X.png?resize=214%2C140&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter that, you\u2019ll be greeted by a Welcome tab with the released notes of the newest version.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/6-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-installed.png?resize=1024%2C767&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThat\u2019s it. Visual Studio Code was successfully installed.<\/p>\n\n\n\n
C) Installing VS Code on Linux Ubuntu (Visual Studio Code)<\/h3>\n\n\n\n
Go to code.visualstudio.com<\/a> and download the stable build for your operating system (Linux Ubuntu).<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/3-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-downloading-VS-Code-Linux-Ubuntu.png?resize=961%2C438&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nSave the installation file:<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/4-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-downloading-VS-Code-Linux-Ubuntu.png?resize=495%2C350&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nTo install it, open a Terminal window, navigate to your Downloads folder and run the following command to install VS Code.<\/p>\n\n\n\n
$ cd Downloads\n~\/Downloads $ sudo apt install .\/code_1.49.1-1600299189_amd64.deb<\/code><\/pre>\n\n\n\nWhen the installation is finished, VS Code should be available in your applications menu.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/5-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-run-VS-Code-Linux-Ubuntu.png?resize=516%2C326&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOpen VS Code, and you\u2019ll be greeted by a Welcome tab with the released notes of the newest version.<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/6-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-downloading-VS-Code-Linux-Ubuntu-Testing.png?resize=1024%2C632&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThat\u2019s it. Visual Studio Code was successfully installed.<\/p>\n\n\n\n
Installing Python<\/h2>\n\n\n\n
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:<\/p>\n\n\n\n
- \n
- A) Installing Python on Windows<\/a><\/li>\n\n\n\n
- B) Installing Python on Mac OS X<\/a><\/li>\n\n\n\n
- C) Installing Python on Ubuntu Linux<\/a><\/li>\n<\/ul>\n\n\n\n
A) Installing Python on Windows<\/h3>\n\n\n\n
Go to python.org\/downloads<\/a> and download Python 3.13.3 or a later version.<\/p>\n\n\n
\n![\"Download](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/04\/download-python-for-windows.png?resize=750%2C429&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOpen the downloaded file to start the Python installation wizard. The following windows show up.<\/p>\n\n\n\n
Important:<\/strong> make sure you check the option Add Python to PATH<\/strong>. Then, you can click on the Install Now<\/strong> button. You may also need to check the “Use admin privileges when installing py.exe”.<\/p>\n\n\n
\n![\"add](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/04\/add-python-path-installation.png?resize=656%2C405&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nIf the installation is successful, you’ll get the following message.<\/p>\n\n\n
\n![\"Python](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/04\/Python-setup-successful.png?resize=656%2C405&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nFinally, click the Close<\/strong> button.<\/p>\n\n\n\n
B) Installing Python on Mac OS X<\/h3>\n\n\n\n
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<\/strong>+Space<\/strong>).<\/p>\n\n\n
\n![\"MacOS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/04\/Mac-OS-spotlight.png?resize=674%2C70&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThen, type “terminal” and click on the Terminal icon to launch it.<\/p>\n\n\n
\n![\"Mac](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/04\/mac-os-launch-terminal.png?resize=750%2C114&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nTo install Python, I’ll be using Homebrew<\/em>. If you don’t have the brew<\/em> command available, type the next command in the Terminal window:<\/p>\n\n\n\n
\/bin\/bash -c \"$(curl -fsSL https:\/\/raw.githubusercontent.com\/Homebrew\/install\/master\/install.sh)\"<\/code><\/pre>\n\n\n\nHere’s how it looks on the Terminal window:<\/p>\n\n\n
\n![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/04\/image.png?resize=860%2C110&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThen, run the brew command to install Python 3.13:<\/p>\n\n\n\n
brew install python3<\/code><\/pre>\n\n\n\nHere’s how it looks on the Terminal window:<\/p>\n\n\n
\n![\"Microsoft](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/2-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-install-Python3.png?resize=632%2C210&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nC) Installing Python on Linux Ubuntu<\/h3>\n\n\n\n
To program the ESP32 boards with ESP-IDF, you need Python 3.5 or a later version installed on your computer.<\/p>\n\n\n\n
Open the Terminal window and check that you already have Python 3 installed. Run the following command:<\/p>\n\n\n\n
python3 --version<\/strong><\/code><\/pre>\n\n\n\nIt should return the current installed version:<\/p>\n\n\n\n
python 3.13.3<\/code><\/pre>\n\n\n\nIf you don’t have Python installed, run the next command to install it:<\/p>\n\n\n\n
sudo apt install python3<\/code><\/pre>\n\n\n\nWhether you already have Python installed or not, you need to run the following command to install Python utilities.<\/p>\n\n\n\n
sudo apt install python3-distutils<\/code><\/pre>\n\n\n\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/09\/2-Getting-Started-VS-Code-PlatformIO-IDE-ESP32-ESP8266-Python3-installed-distutils.png?resize=452%2C91&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nInstalling the ESP-IDF Extension for VS Code<\/h2>\n\n\n\n
To access the ESP-IDF tools, you need to install the official ESP-IDF<\/strong> extension on VS Code. Open VS Code and click the Extensions<\/strong> icon in the left sidebar or click Ctrl<\/strong>+Shift<\/strong>+X<\/strong> to open the Extensions<\/strong> tab.<\/p>\n\n\n\n
Search for “ESP-IDF<\/strong>“, select the ESP-IDF by Espressif Systems<\/strong><\/em> and click the Install<\/strong> button.<\/p>\n\n\n
\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/Installing-ESP-IDF-Extension-VS-Code.png?resize=908%2C401&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nPress the “Trust Publisher & Install<\/strong>” button. The installation will take some time to complete.<\/p>\n\n\n
\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/Installing-ESP-IDF-Extension-VS-Code-Trust-Espressif-Systems.png?resize=589%2C338&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThat’s it! The ESP-IDF extension by Espressif Systems is now installed in your IDE, the following welcome screen should appear.<\/p>\n\n\n
\n![\"VS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/VS-Code-Preparing-ESP-IDF-Installation-preparing.jpg?resize=900%2C614&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNext, follow these instructions to configure the ESP-IDF Extension:<\/p>\n\n\n\n
- \n
- Open the ESP-IDF Espressif extension panel<\/li>\n\n\n\n
- Expand the “Advanced<\/strong>” menu<\/li>\n\n\n\n
- Click the “Configure ESP-IDF Extension<\/strong>” option<\/li>\n\n\n\n
- Choose the “EXPRESS<\/strong>” setup mode to configure the ESP-IDF Tools<\/li>\n<\/ol>\n\n\n
\n![\"VS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/VS-Code-Configure-ESP-IDF-Extension-Express-Option.jpg?resize=900%2C649&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nDuring 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<\/strong>” button.<\/p>\n\n\n\n
Note:<\/strong> you can leave all other default options or change the ESP-IDF directory if you need to.<\/p>\n\n\n
\n![\"VS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/VS-Code-Configure-ESP-IDF-Extension-Express-Seletct-Release-Version-and-Install.jpg?resize=900%2C669&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThat’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.<\/p>\n\n\n
\n![\"VS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/VS-Code-Configuring-ESP-IDF-Extension-Express-Seletct-Release-Version-Completing-Instalation-ESP-IDF-Tools-Python-Virtual-Environment.jpg?resize=900%2C610&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nInstalling the C\/C++ Extensions for VS Code (optional)<\/h2>\n\n\n\n
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<\/strong> icon to open the Extensions<\/strong> tab.<\/p>\n\n\n\n
Search for “C\/C++<\/strong>“, select the first option and click the Install<\/strong> button.<\/p>\n\n\n
\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/Installing-C-and-C-plus-plus-VS-Code.png?resize=919%2C337&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou can also install the “C\/C++ Extension Pack<\/strong>“.<\/p>\n\n\n
\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/05\/Installing-C-and-C-plus-plus-VS-Code-Extension-Pack.png?resize=1020%2C363&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nProgramming ESP32 with ESP-IDF using VS Code<\/h2>\n\n\n\n
That’s it, your ESP-IDF extension has been installed. You can get started programming your ESP32 boards with your first Blink<\/a> project by following our guide ESP-IDF: ESP32 Blink LED Example<\/a>.<\/p>\n\n\n
\n![\"ESP-IDF](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/09\/ESP-IDF-Extension-Installation-Completed-VS-Code-ESP32.jpg?resize=900%2C667&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWrapping Up<\/h2>\n\n\n\n
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.<\/p>\n\n\n\n
Here are some ESP-IDF tutorials that you may find helpful:<\/p>\n\n\n\n
- \n
- Programming ESP32 with ESP-IDF using VS Code \u2013 Getting Started Guide<\/a><\/li>\n\n\n\n
- ESP-IDF: ESP32 Blink LED Example (VS Code)<\/a><\/li>\n\n\n\n
- ESP-IDF: ESP32 GPIO \u2013 Control Digital Outputs<\/a><\/li>\n<\/ul>\n\n\n\n
You can check our ESP32 resources (with Arduino IDE) to learn more about the ESP32 board:<\/p>\n\n\n\n
- \n
- Learn ESP32 with Arduino IDE (eBook)<\/a><\/li>\n\n\n\n
- More ESP32 Projects and Tutorials\u2026<\/a><\/li>\n<\/ul>\n\n\n\n
Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":"
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 … <\/p>\n
- More ESP32 Projects and Tutorials\u2026<\/a><\/li>\n<\/ul>\n\n\n\n
- ESP-IDF: ESP32 Blink LED Example (VS Code)<\/a><\/li>\n\n\n\n
- Click the “Configure ESP-IDF Extension<\/strong>” option<\/li>\n\n\n\n
- B) Installing Python on Mac OS X<\/a><\/li>\n\n\n\n
- B) MacOS X<\/a><\/li>\n\n\n\n
- A) Windows<\/a><\/li>\n\n\n\n