readme.md

Markdown · 57 lines

# ESP32-C3 OLED Captive Portal
### Type text over WiFi and show it on the built-in 0.42" OLED

This project turns an **ESP32-C3 Super Mini (with the on-board 0.42" OLED)** into a small
WiFi text display. When powered, the ESP32-C3 creates an **open WiFi Access Point** and a
**captive portal**. As soon as a device connects to the AP, a page appears where you can
**type any text** — after submitting, the text is shown on the **built-in OLED**.

On boot the display shows by default:

```
mikrobot_pl
flashesp.com
```

---

## ⭐ Features

- **Open WiFi Access Point** (no password)
  - SSID: `ESP32-C3-OLED`
- **Captive portal**
  - Any URL request (e.g. `google.com`) is redirected to the input page
  - Works with Android / iOS / Windows / Linux
- **Web-based text input**
  - Multi-line textarea — each line becomes one row on the OLED
  - Shows the text currently on screen
- **On-board 0.42" OLED output** (72×40, SSD1306)
- No external network or internet required

---

## 📦 Hardware requirements

- **ESP32-C3 Super Mini** with **built-in 0.42" OLED**
- USB-C cable

---


## ▶️ Usage

1. Power the board via USB.
2. Flash to device.
3. The OLED shows the default text (`mikrobot_pl` / `flashesp.com`).
4. On your phone/PC, connect to the WiFi network **`ESP32-C3-OLED`** (open, no password).
5. A captive-portal page opens automatically (or open `http://192.168.4.1`).
6. Type your text in the box — **each line = one row on the OLED** — and press
   **Show on OLED**.
7. The OLED updates instantly.

---

## 🛠️ Troubleshooting

- **Captive portal doesn't pop up** → open `http://192.168.4.1` manually in a browser.
- **Text cut off** → shorten lines or use fewer rows; the panel is only 72×40 px.