This project provides simple HTML files designed for the Evil Portal utility on ESP32 devices. Evil Portal is a technique used to create fake Wi-Fi login pages. These HTML files work with Bruce Firmware, which runs on ESP32 and similar Wi-Fi modules.
The files here are ready-made web pages that your ESP32 device can show to devices that connect. This opens a captive portal or a fake login page for testing or other controlled network environments.
You do not need programming or electronics skills to use these files. You just need an ESP32 device running Bruce Firmware, and then you can add these HTML pages to make your captive portal look right.
Before you start, make sure you have the following:
- An ESP32 device with Bruce Firmware installed. (This README doesn’t cover installing the firmware. Please check Bruce Firmware's documentation separately.)
- A computer or phone connected to the same network for testing.
- Basic ability to copy files from your computer to your ESP32 device.
- A web browser like Chrome, Firefox, or Safari to see the portal after setup.
This project focuses only on the HTML files needed to build the portal’s web pages. It does not include the firmware or software to run on your device. That must already be set up.
Follow these steps to get the HTML files and put them on your ESP32 device:
-
Visit the Download Page
Click or tap the big download badge at the top, or go here directly:
https://github.com/Jalapenothedragon/evil-portal-html/releases -
Download the Latest Release ZIP
On the releases page, look for the latest version. It will have a ZIP file containing the HTML files.
Download the ZIP file to your computer. -
Extract the ZIP File
Open the ZIP file by double-clicking it, or right-click and select extract.
You will find several HTML files inside. -
Connect Your ESP32 to Your Computer
Use a USB cable or network connection as appropriate.
Access the ESP32 file system interface (usually by mounting it as a drive or via firmware tools). -
Copy the HTML Files
Drag and drop or copy all the HTML files you extracted into the ESP32’s designated folder for portal files.
Check your firmware documentation for the exact folder name. -
Restart or Reload Your ESP32
After copying the files, restart the device or reload the portal. This ensures the new pages are loaded.
-
Test the Portal
Connect a device to your ESP32 Wi-Fi. Open a browser and try to access any webpage. Your captive portal with the new HTML pages should appear.
The files here are standard HTML pages. They define how the fake login or captive portal looks. Bruce Firmware serves these pages over Wi-Fi when devices connect.
- index.html is usually the main page users see.
- Other HTML files might provide additional pages, like login success or error pages.
- CSS and image files may be included for styling.
You can edit these files if you want to change the look. Any text editor works well for this, such as Notepad on Windows or TextEdit on Mac.
- ESP32 devices running Bruce Firmware are fully supported.
- Some files may also work with ESP8266-based boards by adjusting firmware settings.
- The HTML code is simple and compatible with all modern browsers on phones and computers.
- No special software is needed to view or edit the files.
If you want to change the text or images shown during your captive portal session:
- Open the HTML files in any plain text editor.
- Edit any text strings to show your custom messages.
- Replace images by saving your own image files with the same name and format.
- Save your changes and upload the files back to the ESP32 as before.
Keep in mind that very large image files or complicated scripts may slow down the portal performance on the device.
- Make sure Bruce Firmware is running and that your ESP32 device is broadcasting the Wi-Fi network.
- Clear your browser cache if you do not see changes after uploading new HTML files.
- Use a simple text editor when editing files to avoid hidden formatting issues.
- If the captive portal does not appear, check that your ESP32 has enough memory to serve the files.
- Test on multiple devices to ensure the portal shows correctly everywhere.
You can get the latest HTML files by visiting the releases page here:
Download evil-portal-html files
Steps to install:
- Download the ZIP file for the newest release.
- Unzip the files on your computer.
- Transfer all HTML files to your ESP32 storage folder.
- Restart your ESP32 for the files to take effect.
This is the main way to get updated portal page designs that work with Bruce Firmware.
- Bruce Firmware documentation: Refer to the official documentation for installing and managing firmware on ESP32 devices.
- ESP32 hardware info: For details on using and programming ESP32 boards.
- Captive Portal guides: Learn more about captive portals and their uses in network security.
bruce, bruce-firmware, captive-portal, cyd, esp32, esp8266, evil-portal, evil-twin, evilportal, eviltwin, html, marauder, marauder-firmware, marauders-esp
This README is designed to help you get the HTML files up and running with your Evil Portal setup on ESP32 devices. Follow the steps carefully to ensure a smooth experience.