# Awesome ESP

A curated list of awesome ESP8266/32 projects and code.

> Both the ESP8266 and the ESP32 are low-cost Wi-Fi microchips with full TCP/IP stack and microcontroller capabilities produced by the Shanghai-based manufacturer Espressif Systems. >
> See Contributing for information on how to contribute to this list. >
—

## Contents

- Firmware
- Tools
- Projects
  - Smart Home and IoT
  - InfoSec
  - Biomedical
  - LoRa
  - Music and Audio
  - Smartwatches
  - Others
- Libraries

## Firmware

- Espressif AT - The default vanilla firmware for the ESP8266.
- NodeMCU - An eLua-based firmware for the ESP8266.
- ESPBasic - A BASIC firmware for easy and wireless programming, ready for the 8266.
- MicroPython - An implemention of Python3 for the ESP8266 and 32.
- ESP3D - An experimental firmware for 3D Printers, both the ESP32 and 8266.
- Frankenstein - A quick and dirty firmware with cool features for the ESP8266.
- MongooseOS - An IoT specific firmware, with both C and JS. Available for the ESP32/8266.
- DeviceHive - A firmware made as a client for DeviceHive’s IoT data platform, only for the 8266.
- RT-Thread - Chinese open source firmware available for the ESP32.
- Sming Framework - Superb C/C++ IoT Framework with support for ESP8266 and ESP32.

## Tools

- ESP Flash Tool - The vanilla firmware flasher for both ESP’s.
- Arduino Core/8266 - The Arduino core for the ESP8266.
- Arduino Core/32 - The other Arduino core for the ESP32.
- ESPTool - Espressif’s command line tool for bootloader comms in both ESP’s.
- ESP-Open-SDK - An open SDK for the ESP8266.
- ESPTool-ck - A CLI tool for flashing in the ESP8266.
- ESPTool-gui - A flashing GUI tool based on ESPTool-ck.
- LuaNode - A lua-only SDK for 32/8266.
- Tuya-Convert - A Wi-Fi firmware flasher ESP8266 that has been pre-loaded with Tuya firmware.
- NodeMCU Flasher - The official flashing tool for the NodeMCU OS.
- Tasmotizer - A graphical flashing tool for Tasmota firmware. Can manage Wi-Fi & MQTT settings, modules & templates.
- Arduino FS Plugin - An Arduino plugin for filesystem uploads in the 8266.
- PlatformIO - Cross Platform IDE and Debugger that supports both the ESP32 and ESP8266.

## Projects

### Smart Home and IoT

- OpenMQTTGateway - An implementation of a multiprotocol MQTT gateway for both ESP’s among other devices.
- ESPHome - A full-featured system for controlling ESP’s through simple yet powerful configuration files and Home Automation systems.
- Tasmota - An alternative firmware for Sonoff & other ESP8266/ESP32 devices. Includes a large collection of sensor drivers & integrates with Home Assistant natively or via MQTT.
- ESPEasy - Easily turn ESP modules into multifunction sensor devices for home automation systems.
- Sonoff-Homekit - An alternative firmware for Sonoff devices (and other 8266 devices) which allows control through Apple’s Homekit.
- DoorsignEPD - A smart doorsign with an E-Paper display using the ESP32.
- EPaperWeatherDisplay - A very cute e-ink weather display using the ESP32.
- HomePoint - Control MQTT/HomeKit smart home devices from an ESP32-powered screen.
- openHASP - Control your home automation devices from a customizable touchscreen UI connected via MQTT.
- SuperGreenOS - A full-featured home farming automation software for the ESP32.
- CanAirIO - Citizen science project that uses mobile and fixed stations to measure air quality with ESP32 and smartphones.

### InfoSec

- ESP32-BLECollector - A wardriving device which displays BLE devices and collects data from them, all in a nice screen interface.
- ESP32Marauder - An integrated suite of offensive and defensive tools for WiFi and Bluetooth.
- ArduinoPcap - A library which allows generation of .pcap files with network traffic, for both ESP’s.
- WiFi Satellite - A giant Wifi “satellite” that can monitor all 14 2.4Ghz channels using, well, 14 ESP32s.
- ESP8266 Deauther - A very cool pseudojammer (deauther) of Wifi networks that uses the ESP8266.
- PacketMonitor - A beautiful OLED monitor for packet activity in a WiFi channel. Two versions for each ESP.
- WiFiDuck - A wireless-enabled keystroke injector, analogous, but even more awesome than the Rubber Ducky.
- ESP8266 Beacon Spam - Want to confuse people? This device creates hundreds of fake WiFi networks.
- DeauthDetector - A small device that shines a light if it detects a WiFi deauth attack. Made by the same guy as the last six projects.

### Biomedical

- HeartyPatch - A wearable BLE and WiFi connected ECG-HR patch which uses the ESP32.
- HealthyPi v4 - An amazing open source vital signs monitor that can monitor ECG, respiration, pulse oximetry and body temperature, all run by an ESP32.

### LoRa

- Meshtastic - ESP32 LoRA boards as secure, long battery life, mesh GPS communicators.
- ESP32-Paxcounter - Wifi & Bluetooth driven, LoRaWAN enabled, battery powered mini Paxcounter built on cheap ESP32 LoRa IoT boards.
- Disaster Radio - A disaster-resilient communications network powered by the sun.

### Music and Audio

- Alles - A many speaker distributed music synthesizer using UDP multicast over WiFi, modeled after the alles machine/AMY.
- ESP32-Radio - Internet radio based on ESP32, VS1053 and a TFT screen.
- ESPuino - RFID-controlled music player powered by ESP32.
- Knobby - A handheld Spotify remote that encourages you to explore unfamiliar music.
- PedalinoMini - A wireless MIDI pedal controller for guitarists, built with the ESP32.
- Squeezelite-esp32 - Streaming audio receiver with multi-room sync, AirPlay, Bluetooth, hardware buttons, display and more.
- ThingPulse esp8266-spotify-remote - Control your Spotify player from a ESP8266 with color touch display.

### Smartwatches

- mutantW_V1 - An ESP32 based open source smartwatch with 1.7 inch display, WiFi, Bluetooth, NeoPixel and vibration.
- Open SmartWatch - A FOSS smartwatch with GPS, an inertial unit and an extremely cool 3D-printed case.
- StickWatch - A smartwatch module based on the M5Stick, using the ESP32.
- Watchy - An open source e-paper watch with lots of options for customization.

### Others

- SoftRF - A DIY aviation proximity awareness system that can be used in UAV projects.
- Retro ESP32 - An extremely cool launcher for the Odroid Go (with the ESP32), which allows emulating several retro consoles.
- DroneBridge - An implementation of DroneBridge, a signal link for drones and UAV’s on the ESP32.
- E-TKT - An ESP32 powered DIY label maker that mixes both old fashioned and contemporary technology.
- FreeTouchDeck - Open source touch macropad and stream control deck with built-in web configurator.
- SmartSpin2k - Transform your spin bike into a smart trainer with automatic resistance knob control in fitness apps like Zwift.
- WirelessPrinting - Print wirelessly from Cura, PrusaSlicer or Slic3r to your 3D printer connected to an ESP module.
- WLED - Control many types of RGB(W) LED strips with an ESP8266 or ESP32 over WiFi.

## Libraries

- Wasm3 - A lightning fast WebAssembly interpreter designed for embedded devices, compatible with both ESP’s.
- Homie8266 - Framework implementation of the Homie protocol for the 8266.
- ESP-Dash - Beautiful and fast framework for creating remote dashboards in the 8266/32. No internet required.
- ESP_mqtt - MQTT helper library for the ESP8266.
- GUIslice - A drag and drop GUI framework for several devices and screen controllers. Compatible with 8266 and 32.
- LVGL - An open-source graphics library providing everything you need to create embedded GUIs with easy-to-use graphical elements, beautiful visual effects and low memory footprint.
- MicroWebSrv2 - A very powerful MicroPython web server which can be used in the ESP32.
- IRremoteESP8266 - Emit and receive IR signals in the ESP8266.
- esphomelib - Framework to integrate with HomeAssistant in the 8266.
- TTS - A somehow good text to speech library for several Arduino devices, both ESP’s included.
- Free802.11 - Library to emit arbitrary 802.11 signals with the ESP32.
- Koyn - A decentralized Bitcoin library for the ESP32 and the ESP8266.
- TFTLibrary - TFT compatibility for the ESP32.
- UTFT-ESP - UTFT Support for the ESP32/8266.
- ESPAudio - Library for playing a diverse range of audio formats in the ESP8266/ESP32.
- ESP32-audioI2S - Plays mp3, m4a and wav files from SD card or stream via I2S interface.
- AsyncTCP - Asynchronous TCP Library for both the 8266 and the 32.
- ESP-HomeKit - Homekit implementation for 8266 on RTOS.
- HomeSpan - A robust and extremely easy-to-use Arduino library for creating your own ESP32-based HomeKit devices.
- ESPHelper - MQTT and Wi-fi automation-oriented library for the 8266.
- ESPHelper/32 - Port of the ESPHelper library for the 32.
- ESP8266Wifi - Simple Arduino Wifi library for the 8266.
- WiFiESP - Arduino library for Wifi management, client/server for 8266 board.
- TinyGSM - A quick and simple Arduino library for interaction with GSM modules which can also control the 8266 through AT commands.
- mJS - A lightweight and restricted JS engine that is used by MongooseOS, compatible on the 32 and 8266.
- ESPUI - A simply library for making interactive web interfaces for both ESP’s.
- ESP32 ePaper - A full-featured library for using ePaper modules with the ESP32.
- TinyUPnP - A lightweight UPnP IGD library for automatic port forwarding on the 8266 and 32.
- Esp32SSHClient - A library that implements a SSH client in the ESP32.
- painlessMesh - A library that takes care of the particulars of creating a simple mesh network using ESP8266 and ESP32 hardware.
- WifiEspNow - Arduino library for ESP-NOW, a connectionless WiFi communication protocol defined by Espressif.
- go-mcu - Golang package for interacting with NodeMCU-based boards.
- CanAirIO SensorLib - ESP32/8266 library with auto-configuration of multiple PM2.5, CO2 and environment sensors.
- Dhyara - A C/C++ library for making a Mobile Ad hoc Network (MANET) using ESP Now.
- LedFx - A library for using audio input to create realtime light shows. LedFx can control multiple devices and works great with cheap ESP8266 nodes.

esp.md Github