ESP32-S2 Wi-Fi File Downloader Firmware

One Click is a compact ESP32 firmware that enables instant file downloads over Wi-Fi. Power it up, connect to the access point, and grab your files directly from the browser — no drivers, cables, or setup tools.

• Single-click file download over Wi‑Fi
• Standalone Access Point mode — no router needed
• SPIFFS support
• Optional access password
• Built with ESP-IDF for stability and speed
• Works on all major operating systems

• ESP32-S2 / ESP32-S3
• Power supply: 5 V via USB or VIN

• ESP-IDF v5.5

One Click works on every major operating system without additional drivers:

• Windows — Chrome, Edge, Firefox, Opera, etc.
• macOS — Safari, Chrome, Firefox, etc.
• Linux — All major distributions (Ubuntu, Fedora, Debian, Arch, etc.)
• Android — Chrome, Firefox, Samsung Internet, etc.
• iOS — Safari, Chrome, Firefox, etc.
• Smart TVs / IoT devices — Any device with a web browser.

No special apps, drivers, or installations are required — just connect to the ESP32 access point and use a browser.

git clone https://github.com/yourusername/one-click.git
cd one-click

idf.py set-target esp32
idf.py build
idf.py -p COMx flash monitor

(Replace COMx with your device’s COM port.)

Edit main/config.h to customize your firmware:

#define WIFI_SSID       "OneClickAP"
#define WIFI_PASS       "12345678"      // Leave blank for open network
#define MAX_CONN        4
#define FILE_PATH       "/spiffs/file.zip"

1. Flash the firmware to your ESP32.
2. Power it on — it will create a Wi‑Fi access point.
3. Connect to the AP using a device.
4. Click the file download link to get your file.

Place your file in the spiffs folder, then build the SPIFFS image:

idf.py spiffs_create
idf.py -p COMx flash

• Optionally protect your AP with a password.
• Only serves files stored in SPIFFS.

Contributions are welcome! Please open issues or pull requests for improvements or bug fixes.

MIT License — free to use, modify, and distribute. See LICENSE for details.