ESP IDE je desktopový editor a učební prostředí pro MicroPython na deskách ESP a RP2. Nabízí vizuální programování v Blockly i textový Python editor, přímé připojení přes USB‑Serial nebo Bluetooth Low Energy, správu souborů na zařízení a průvodce instalací firmware i knihoven.
- Funkce
- Podporované desky
- Požadavky
- Rychlé spuštění z kódu
- Build instalátorů
- Jak s aplikací pracovat
- Poznámky k systému a bezpečnosti
- FAQ
- Příspěvky a hlášení chyb
- O Autorovi
- Dva režimy práce
- Blockly pro vizuální skládání programů.
- Text s ACE editorem, záložkami, Undo/Redo a indikací rozpracovanosti.
- Správce souborů (File Manager): prohlížení, upload/download, mazání a úpravy souborů na připojeném zařízení. Přenos respektuje limity USB/BLE.
- Připojení k zařízení:
- USB (WebSerial) – výběr portu přes vlastní Port Picker.
- Bluetooth LE – výběr zařízení přes vlastní BT Picker; volba je skryta tam, kde deska BLE nepodporuje.
- Průvodci instalací:
- flash firmware (ESP32/ESP8266) nebo zobrazení pokynů pro UF2 (RP2),
- následná instalace knihoven.
- instalátor firmware najdete zde : https://espide.eu/instalace_new/
- Rozšíření (Extensions): přidání vlastních bloků a toolbox XML, uložení do
localStoragea bezpečná integrace do UI. - Changelog a verze v UI: rychlý přehled novinek přímo v aplikaci.
- Vývojářské nástroje: klávesa F12 otevře/zavře DevTools.
- ESP32, ESP32‑C3, ESP32‑S3, ESP8266
- RP2040 (vč. Pico/Pico:ed) a další RP2 kompatibilní desky
BLE je dostupné na ESP32/C3/S3. U desek bez BLE je volba automaticky skryta.
- Node.js LTS (doporučeno 18+) a npm
- Git (pro klonování repozitáře)
- OS: Windows, Linux, nebo macOS
git clone https://github.com/mispacek/ESP-IDE-Electron-desktop-app.git
cd ESP-IDE-Electron-desktop-app
npm install
npm start
npm startspouští Electron a načte hlavní okno s povolenými rozhraními pro WebSerial/BLE.
Nejjednodušší je použít přednastavené skripty z package.json:
# vše podle host OS
npm run dist
# cílené buildy
npm run dist:win # Windows (NSIS)
npm run dist:linux # Linux (AppImage + DEB)
npm run dist:mac # macOS (DMG/ZIP, hardened runtime)Vnitřně se používá electron‑builder. Artefakty se pojmenovávají např.:
ESP_IDE_<verze>_<os>_<arch>.<ext>
Pozn.: U DEB probíhá
postinstallkrok. macOS build používá hardened runtime a entitlements včetně popisu pro Bluetooth.
-
Volba procesoru při startu
Zvolte cílovou desku (ESP32, ESP32C3, ESP32S3, ESP8266, RP2040, Pico:ed). Volba ovlivní toolbox a dostupnost BLE. -
Připojení k desce
- USB: klikněte na tlačítko USB, otevře se Port Picker s výběrem sériového portu.
- BLE: u desek s BLE klikněte na tlačítko BLE, zobrazí se BT Picker a proběhne připojení k REPL.
-
Blockly ↔ Text
Přepínejte mezi vizuálním a textovým režimem. Textový editor používá ACE, pamatuje rozpracované soubory i otevřené záložky. -
Správa souborů
Otevřete File Manager. Nahrávejte soubory do zařízení, stahujte je, mažte a editujte. Přenos je přizpůsoben USB/BLE kanálu. -
Instalace firmware a knihoven
Spusťte průvodce v menu.- ESP32/ESP8266: flash přímo z aplikace.
- RP2: zobrazení pokynů pro UF2; po potvrzení pokračuje instalace knihoven.
-
Rozšíření (extensions)
Nahrajte/zkopírujte JS a XML bloků, povolte je a nechte zaintegrovat do toolboxu. Stav se ukládá dolocalStorage.
- WebSerial a oprávnění: aplikace využívá experimentální webové funkce a vlastní výběr portu uvnitř aplikace.
- BLE výběr: události
select-bluetooth-deviceabluetooth-device-addedjsou mapované na vlastní BT Picker a řízené zavírání okna. - Linux parametry: pro spolehlivý přístup k USB se používá
--disable-serial-blocklista na některých distribucích může být nutné upravit udev pravidla. - Hlavní okno:
contextIsolation: true, renderer bez Node integrace. Splash okno je izolované.
USB zařízení se nezobrazuje na Linuxu
Zkontrolujte udev pravidla pro USB‑serial adaptéry. Některá prostředí vyžadují spuštění s --disable-serial-blocklist. U DEB probíhá postinstall, AppImage může vyžadovat manuální úpravy.
Nevidím BLE volbu
Zvolená deska BLE nepodporuje (např. ESP8266, RP2040). Změňte volbu procesoru v menu.
Kde zapnu DevTools?
Klávesa F12.
Jak vyčistit lokální data aplikace (cache, nastavení)
Smažte složku userData pro aplikaci „ESP IDE“:
- Windows:
%APPDATA%/ESP IDE/ - Linux:
~/.config/ESP IDE/ - macOS:
~/Library/Application Support/ESP IDE/
- Vytvořte Issue s jasným popisem problému a kroky k reprodukci.
- U pull requestů popište záměr, dopad na uživatele a případné změny v build procesu nebo oprávněních.
- Autor: Milan Špaček, programátor a nadšenec do vzdělávání dětí.
- Celé prostředí tvoří ve svém volném čase pro děti na zájmovém kroužku Energie Jinak https://www.energiejinak.cz/
ESP-IDE-Offline-desktop-app
If you install the application manually or run it from sources, configure the permissions for serial ports with the following commands:
sudo cp 99-espide-serial.rules /etc/udev/rules.d/
sudo chmod 644 /etc/udev/rules.d/99-espide-serial.rules
sudo usermod -aG dialout <username>
sudo udevadm control --reload-rules
sudo udevadm triggerThese steps are executed automatically by postinstall.sh when installing the
.deb package.
Download the installer for your platform from the release page. File names have the following format:
ESP_IDE_<version>_<platform>.<extension>
Use the file that matches your operating system:
Run the installer ESP_IDE_<version>_win_<arch>.exe and follow the prompts.
Select the x64 file for 64‑bit systems or ia32 for 32‑bit.
On Debian‑based systems install the .deb package:
sudo dpkg -i ESP_IDE_<version>_amd64.debFor other distributions use the AppImage. Make it executable and run it:
chmod +x ESP_IDE_<version>_linux_x64.AppImage
./ESP_IDE_<version>_linux_x64.AppImageMount ESP_IDE_<version>_mac_universal.dmg and drag the application to the
Applications folder. Alternatively unpack the zip archive with the same prefix.