README.md

January 27, 2026 · View on GitHub

Espressif-IDE

The official Eclipse-based IDE for ESP-IDF development

GitHub Release License GitHub Issues Build Status

macOS Windows Linux

Documentation · Download · Report Bug · 中文


Espressif-IDE is a standalone, customized IDE built on Eclipse CDT for developing IoT applications with ESP-IDF. It bundles the IDF Eclipse plugins, Eclipse CDT, and essential third-party plugins into a single ready-to-use environment for the entire ESP32 family of chips.

Key Features

Write

FeatureDescription
Project WizardsCreate new projects from scratch or from 100+ ESP-IDF example templates
Clangd-Powered EditorLSP-based C/C++ editor with code completion, navigation, and real-time diagnostics
CMake EditorSyntax highlighting and content assist for CMakeLists.txt files
SDK Configuration (menuconfig)Visual editor for Kconfig options -- no terminal needed

Build

FeatureDescription
CMake Build SystemFull integration with ESP-IDF's CMake-based build
Toolchain ManagementAuto-configured ESP GCC and Clang toolchains
ESP-IDF ManagerInstall, manage, and switch between multiple ESP-IDF versions from inside the IDE
Size AnalysisVisualize your firmware's static memory footprint (RAM/Flash)

Flash

FeatureDescription
UART FlashingOne-click flash over serial using idf.py flash
JTAG FlashingFlash via JTAG debug probes
DFU FlashingFlash over USB using Device Firmware Update protocol
Partition Table EditorVisual editor for custom partition layouts
NVS EditorCreate and edit Non-Volatile Storage partition data

Debug

FeatureDescription
OpenOCD DebuggingFully integrated JTAG debugging with pre-built launch configurations
GDB Stub DebuggingDebug panics and exceptions over serial
Core Dump AnalysisPost-mortem debugging from crash dumps
Heap TracingProfile memory allocations and detect leaks at runtime
App-Level TracingCollect real-time trace data from running firmware

Monitor & Simulate

FeatureDescription
Serial MonitorIntegrated terminal for viewing device output
ESP-IDF TerminalPre-configured shell with all build environment variables set
Wokwi SimulatorTest your firmware on a virtual ESP32 -- no hardware required

Quick Start

Download the latest standalone installer from the releases page for your platform.

Option 2: Install the Plugin into an Existing Eclipse

Install from the Eclipse Marketplace or the update site. See the installation guide for details.

First Steps

  1. Launch Espressif-IDE
  2. Install ESP-IDF and tools through the built-in ESP-IDF Manager
  3. Create a new project using File > New > Espressif IDF Project
  4. Select a target chip and serial port
  5. Build, flash, and monitor

Full walkthrough in the official documentation.

Building from Source

Prerequisites: Java 17+ and Maven 3.9+

git clone https://github.com/espressif/idf-eclipse-plugin.git
cd idf-eclipse-plugin
mvn clean verify -Djarsigner.skip=true

The p2 update site artifact is generated at releng/com.espressif.idf.update/target/. Install it using the local archive instructions.

Getting the Latest Development Build

  1. Go to the latest commits on master
  2. Click the green checkmark on the latest commit
  3. Click Details > Summary
  4. Download the com.espressif.idf.update artifact from the Artifacts section
  5. Install using the local archive instructions

Contributing

We welcome contributions! See CONTRIBUTING.md for development environment setup, coding guidelines, and how to submit pull requests.

Resources

Reporting Issues

Found a bug or have a feature request? Please open an issue here with your environment details and relevant logs.

License

This project is licensed under the Eclipse Public License v2.0.