openwifichecker

📶 Open WiFi Internet Finder

Detect nearby OPEN and WEP Wi-Fi networks and (for OPEN only) check whether they provide real Internet access.
Optimized for the M5Stack Cardputer (ESP32-S3) with a fast, low-flicker dashboard UI.

---

🧠 What is this module?

Open WiFi Internet Finder continuously scans for Wi-Fi networks and keeps a short, real-time list of:

• OPEN networks (no password) — optionally tested for Internet access
• WEP networks — shown for awareness only (no cracking, no testing)

For OPEN networks, the Cardputer can temporarily connect and run a lightweight connectivity test to decide if the network is: UNKNOWN, NO INTERNET, or INTERNET OK.

---

🚀 Workflow

Nearby Wi-Fi Networks
        │
        ▼
[1] Async Scan (STA mode, hidden SSIDs included)
        │
        ▼
[2] Keep only OPEN + WEP (real-time list with TTL)
        │
        ▼
[3] Scheduled Testing (OPEN only, RSSI-gated)
        │
        ▼
[4] Status Classification:
    - UNKNOWN (not tested yet)
    - NO INTERNET
    - INTERNET OK
        │
        ▼
[5] Live Dashboard UI + Optional Beep on new OPEN+INTERNET

---

🎨 UI & Color Meaning

The left list is color-coded for quick decision making:

• Green → OPEN network with Internet OK (sorted by strongest RSSI first)
• White → OPEN network UNKNOWN (not tested yet)
• Red → OPEN network NO INTERNET (or blocked connectivity test)
• Yellow → WEP network (listed only)

The right panel shows live stats:

• Seen → total networks seen in the last scan (all types)
• Open → OPEN networks seen in the last scan
• NetOK → OPEN networks confirmed with Internet
• Beep → ON/OFF state (sound alert when a new OPEN+INTERNET is discovered)

---

⌨️ Controls

• S → Toggle Beep ON/OFF (sound when a new OPEN+INTERNET is detected)
• BACKSPACE → Exit and return to menu

---

🌍 How “Internet OK” is detected

For OPEN networks only, the device may temporarily connect and perform a quick HTTP connectivity check using:

http://clients3.google.com/generate_204

If the expected response is received, the network is marked as INTERNET OK. If the device cannot connect, times out, or the check is blocked/captive, it is marked as NO INTERNET.

---

⚙️ Stability & Smart Testing (what makes it usable)

• Async scanning to keep UI responsive
• Short TTL for networks (list stays “fresh”)
• RSSI gate: very weak networks are skipped for testing to avoid wasting time
• Retest scheduling:
  • Successful networks are rechecked less often
  • Failed networks can be retried sooner
• Low flicker UI using sprites + “dirty” redraw logic

---

📁 Output / Files

This dashboard is designed for live use and does not export results by default. All information is displayed in real time on screen and in serial logs.

---

⚠️ Limitations

• WEP networks are not tested and are shown only for awareness.
• Captive portals may appear as NO INTERNET because the connectivity endpoint is blocked/redirected.
• Some networks block the test URL; results may vary depending on filtering/DNS policies.
• The list is intentionally short-lived (TTL) to reflect what is currently in range.

---

❓ FAQ

Is this an “auto connect” tool?

It is a scanner + verifier. For OPEN networks, it may connect briefly in order to verify Internet connectivity. It does not attempt authentication attacks, cracking, or bypass.

Why do some OPEN networks show “NO INTERNET” even though they work on my phone?

Many OPEN networks require a captive portal (web login/accept page) or block the test endpoint. In such cases the Cardputer cannot confirm direct Internet access and will classify it as NO INTERNET.

Why are WEP networks listed?

WEP is legacy and insecure. Listing WEP networks is useful for audits and awareness, but this module does not try to crack or connect to them.

---

⚠️🚨 LEGAL & AUTHORIZATION WARNING 🚨⚠️

Scanning and connecting to networks you do not own or have permission to test may be illegal.
Use this module only on networks you own or where you have explicit authorization (lab, assessment, or controlled environment).