MCPcopy Index your code
hub / github.com/Jason2866/ESP_Flasher

github.com/Jason2866/ESP_Flasher @v4.5.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v4.5.0 ↗ · + Follow
593 symbols 1,710 edges 14 files 204 documented · 34% updated 48d agov4.5.0 · 2026-05-20★ 2502 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Tasmota-ESP-Flasher for Tasmota v13 and later (Safeboot partition scheme)

GitHub Releases

Tasmota-ESP-Flasher is an app for ESP8266 / ESP32 designed to make flashing Tasmota on ESPs as simple as possible by:

  • Pre-built binaries for most used operating systems
  • Support for Tasmota factory images
  • Hiding all non-essential options for flashing
  • All necessary options (bootloader, flash mode, safeboot) are set automatically
  • Flashing is lightning fast
  • Full ANSI color support for colored terminal output
  • Interactive serial monitor with command input support (with history buffer)

The flashing process is done using esptool from espressif.

Installation

  • Check the releases section for your OS.
  • Download and double-click and it'll start.

  • The native Python version can be installed from PyPI: pip install esp-flasher. Start the GUI by esp_flasher. Alternatively, you can use the command line interface ( type esp_flasher -h for info)

  • Only Linux:

sudo usermod -a -G dialout $(whoami)

after the command has fired and a relogin the Flasher can access the serial ports and flash away

Usage Guide

Flash Process

The flashing process is straightforward and consists of a few simple steps:

1. Select Serial Port

Connect your ESP device via USB and select the correct serial port from the dropdown menu.

2. Connect to Device

Click the "Connect" button to establish a connection with your ESP device.

3. Select Firmware

Click "Select Firmware" to choose the matching Tasmota (factory) firmware file (.bin) to the connected espressif MCU.

4. Start Flashing

Click "Flash ESP" to begin the flashing process. The progress bar shows the current status.

5. Flash Complete

Once flashing is complete, you'll see a success message. Your device is now ready to use.

Flash

6. WiFi Improv Support

The ESP Flasher includes WiFi Improv protocol support, allowing you to configure WiFi credentials on your ESP device without connecting to a web interface or access point.

Improv

How to use WiFi Improv:

  1. After flashing your device, keep it connected via USB
  2. Click the Improv WiFi button to launch the Improv client
  3. Click the Scan Networks button to search for available WiFi networks
  4. Double-click the WiFi network you want to connect to
  5. The SSID field will be automatically filled with the selected network name
  6. Enter your password in the Password field and click the Provision button
  7. The device will connect to your WiFi network and display the assigned IP address

Benefits: - No need to connect to a temporary access point - Secure credential transfer over USB - Faster initial setup process - Works immediately after flashing

For more details on the Improv protocol, visit Improv WiFi.

Documentation

Tasmota ESP Flasher and Tasmota ESP Flasher Wiki

In the odd case of your antivirus going haywire over that application, it's a false positive.

Build it yourself

If you want to build this application yourself you need to:

  • Install Python >= 3.9
  • Download this project and run pip3 install -e . in the project's root.
  • Start the GUI using esp_flasher. Alternatively, you can use the command line interface ( type esp_flasher -h for info)

To create a standalone binary, use PyInstaller with the provided spec file:

pip install -r requirements.txt -r requirements_build.txt
pyinstaller ESP-Flasher.spec

For detailed build instructions, see build-instructions.md.

Mac OSX (compiled binary only for 11 and newer)

Driver maybe needed for Mac OSx.

Info: https://www.silabs.com/community/interface/forum.topic.html/vcp_driver_for_macosbigsur110x-krlP

Driver: https://www.silabs.com/documents/public/software/Mac_OSX_VCP_Driver.zip

License

MIT © Otto Winter, Michael Kandziora, Johann Obermeier

Build_special_firmware

Powered by

CLion logo.

Core symbols most depended-on inside this repo

read_reg
called by 114
esp_flasher/own_esptool.py
write_reg
called by 62
esp_flasher/own_esptool.py
write
called by 45
esp_flasher/own_esptool.py
read
called by 40
esp_flasher/own_esptool.py
connect
called by 37
esp_flasher/own_esptool.py
colorize
called by 26
esp_flasher/own_esptool.py
_setRTS
called by 24
esp_flasher/own_esptool.py
check_command
called by 20
esp_flasher/own_esptool.py

Shape

Method 436
Function 86
Class 71

Languages

Python100%

Modules by API surface

esp_flasher/own_esptool.py447 symbols
esp_flasher/gui.py57 symbols
esp_flasher/common.py24 symbols
esp_flasher/serial_console.py20 symbols
esp_flasher/improv.py17 symbols
esp_flasher/console_color.py12 symbols
examples/serial_console_example.py5 symbols
esp_flasher/__main__.py5 symbols
examples/colored_output_example.py4 symbols
test_ansi_colors.py1 symbols
esp_flasher/helpers.py1 symbols

For agents

$ claude mcp add ESP_Flasher \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact