Skip to content

localrice/EasyWiFi

Repository files navigation

EasyWiFi

EasyWiFi Logo

Library for effortless WiFi management. It supports automatic connection with credential storage, captive portal configuration, and optional static IP—all with minimal code required.

(This library doesn't try to replace tzapu/WiFiManager but serves as a more simple, barebones and light library)


The EasyWiFi library depends on the following external libraries:

  • Arduino.h — Core Arduino functions

  • LittleFS.h — For file system storage and reading/writing WiFi credentials

  • ESP8266WiFi.h — WiFi management on ESP8266 hardware

  • ESP8266WebServer.h — Embedded web server for the captive portal

  • DNSServer.h — DNS server to redirect to captive portal during setup.


API Overview:

  • begin() – Starts WiFi with credential storage and provisioning logic.

  • loop() – Handles captive portal, reconnection, and HTTP server events.

  • reset() – Removes stored credentials and clears configuration.

  • saveCredentials(const char* ssid, const char* password) – Explicitly save new SSID and password.

  • loadCredentials() – Loads credentials from the filesystem.

  • printCredentials() – Prints credentials to serial for review.

  • setAP(const char* name, const char* password) – Customizes the name and password of the captive AP.

  • setCSS(const char* cssUrl) – Use a custom CSS file for the captive portal.

  • setReconnectParams(int maxAttempts, unsigned long interval) – Configure reconnect behavior.

  • setStaticIP(IPAddress ip, IPAddress gateway, IPAddress subnet, IPAddress dns) – Enable static IP mode


Thanks to Holorizu for the logo.

About

Minimal WiFi Manager for ESP8266

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages