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-clickidf.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"- Flash the firmware to your ESP32.
- Power it on — it will create a Wi‑Fi access point.
- Connect to the AP using a device.
- 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.