esp32-wifimanager 2.0.0

WiFi Manager for ESP32 running MicroPython

WiFiManager (MicroPython – ESP32)

A smart and flexible Wi-Fi manager for ESP32 using MicroPython. Supports auto-connect, AP fallback, JSON-based configuration, and dynamic network management.

---

🚀 Features

• Auto-connect to strongest saved network
• Fallback to Access Point (AP) mode
• JSON-based configuration (networks + AP settings)
• Quick connect to new networks
• Dynamic AP configuration
• Network scanning
• Lightweight and optimized for MicroPython

---

📦 Installation

pip install esp32-wifimanager

Or manually:

• Copy wifiManager/ folder to ESP32
• Create wifi.json file (optional)

---

⚙️ Configuration File (wifi.json)

{
  "networks": [{ "ssid": "Home", "password": "12345678" }],
  "AP": {
    "essid": "ESP32_AP",
    "password": "12345678",
    "channel": 6
  }
}

---

⚡ Quick Start

from wifiManager import WiFiManager

wifi = WiFiManager(debug=True)
print(wifi.connect())

---

🔌 Connection Flow

1. Scan nearby networks
2. Match with saved networks
3. Connect to strongest signal
4. If failed → Start AP mode

---

📡 Quick Connect (New 🔥)

Connect to a network and save it automatically:

wifi.quick_connect("MyWiFi", "12345678")

---

📊 Status APIs

STA Status

wifi.status_sta()

Output:

{
  "status": true,
  "ssid": "MyWiFi",
  "ip": "192.168.1.10"
}

AP Status

wifi.status_ap()

---

📡 Access Point Control

Start AP

wifi._ap()

Update AP Settings

wifi.update_ap(essid="NEW_AP", password="87654321", channel=11)

---

📁 Network Management

Add Network

wifi.add_network("MyWiFi", "12345678")

Remove Network

wifi.remove_network("MyWiFi")

Clear All Networks

wifi.clear_networks()

---

⛔ Stop Interfaces

wifi.stop_all()
wifi.stop_sta()
wifi.stop_ap()

---

📡 Scan Networks

wifi.scanner.scan()

---

⚠️ Migration Guide (v1 → v2)

❌ Old

wifi = WiFiManager(ap_essid="ESP32", ap_password="12345678")
wifi.connect()

✅ New

wifi = WiFiManager()
wifi.connect()

👉 AP settings are now stored in wifi.json

---

❌ Old Response

{ "STATUS": "CONNECTED!", "IP": "..." }

✅ New Response

{ "status": true, "ip": "..." }

---

🧠 Notes

• AP settings are persistent via JSON
• quick_connect() automatically saves networks
• Better memory handling and stability
• Designed for IoT production use

---

📜 License

MIT License