A library to make using WiFi and MQTT on ESPXX platforms easy.

I wrote this library to help with my own home automation projects. It handles connecting (and reconnecting when the connection is lost) for both a wifi network and MQTT broker. When reconnecting it automatically resubscribes to subscribed topics on an MQTT broker. It is also capable of automatically hopping between different network/MQTT setups (I wrote this is mostly so that I could move from my home network to work and have my prototypes be able to connect to whatever environment was most convinient)

The library also features the ability to use the ArduinoOTA system for OTA updates. There are a number of wrapper methods for enabling/disabling OTA and changing the OTA hostname and password.

Please take a look at the examples included with this library to get an idea of how it works.


This library does requre the use of these libraries (so make sure they're installed as well!):

Useful Methods:

  • bool begin(); //must be called (once) to start the system

  • int loop(); //must be called as often as possible to maintain connections and run the various subsystems

  • bool subscribe(char* topic); //subscribe to a given MQTT topic (will NOT auto re-subscribe on connection lost)

  • bool addSubscription(char* topic); //add a topic to the subscription list (will auto re-subscribe on connection lost)

  • bool removeSubscription(char* topic); //remove a topic from the subscription list and unsubscribe

  • void publish(char* topic, char* payload); //publish a given MQTT message to a given topic

  • bool setCallback(MQTT_CALLBACK_SIGNATURE); //set the callback for MQTT (must be called after begin() method)

  • void updateNetwork(); //manually disconnect and reconnecting to network/mqtt using current values (generally called after setting new network values)

  • String getIP(); //get the current IP of the ESP module

  • void setHopping(bool canHop); //enable/disable hopping between networks in a net list
  • void OTA_enable(); //enable the OTA subsystem

  • void OTA_disable(); //disable the OTA subsystem

  • void OTA_begin(); //start the OTA subsystem

  • void OTA_setPassword(char* pass); //set a password for OTA updates

  • void OTA_setHostname(char* hostname); //give a hostname to the device for OTA identification


  • Integrate Last Will into config files and config page
  • Implement callback for lost WiFi connection


A library to make using WiFi & MQTT on the ESP8266 easy.

Esphelper Info

⭐ Stars 320
🔗 Source Code
🕒 Last Update 5 months ago
🕒 Created 6 years ago
🐞 Open Issues 7
➗ Star-Issue Ratio 46
😎 Author ItKindaWorks