{"id":18259002,"url":"https://github.com/roguemaster/flipperzero-evil-portal","last_synced_at":"2025-04-08T23:36:58.080Z","repository":{"id":185166281,"uuid":"673103597","full_name":"RogueMaster/flipperzero-evil-portal","owner":"RogueMaster","description":"Evil portal app for the flipper zero + WiFi dev board, Works on OFW, better on RM!","archived":false,"fork":false,"pushed_at":"2025-01-31T21:11:15.000Z","size":1254,"stargazers_count":175,"open_issues_count":0,"forks_count":9,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-06T11:49:29.337Z","etag":null,"topics":["flipper","flipper-zero","flipperzero","pentesting","roguemaster","wifi","wifi-hacking","wifi-hotspot","wifi-network","wifi-security"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"bigbrodude6119/flipper-zero-evil-portal","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RogueMaster.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-31T22:06:06.000Z","updated_at":"2025-03-28T05:58:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"fb3ae5d3-c6c9-4806-a555-3cbffb07fa3e","html_url":"https://github.com/RogueMaster/flipperzero-evil-portal","commit_stats":null,"previous_names":["roguemaster/flipper-zero-evil-portal"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RogueMaster%2Fflipperzero-evil-portal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RogueMaster%2Fflipperzero-evil-portal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RogueMaster%2Fflipperzero-evil-portal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RogueMaster%2Fflipperzero-evil-portal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RogueMaster","download_url":"https://codeload.github.com/RogueMaster/flipperzero-evil-portal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247947823,"owners_count":21023058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flipper","flipper-zero","flipperzero","pentesting","roguemaster","wifi","wifi-hacking","wifi-hotspot","wifi-network","wifi-security"],"created_at":"2024-11-05T10:35:51.268Z","updated_at":"2025-04-08T23:36:58.056Z","avatar_url":"https://github.com/RogueMaster.png","language":"HTML","funding_links":["https://www.patreon.com/RogueMaster?filters","https://www.patreon.com/RogueMaster"],"categories":[],"sub_categories":[],"readme":"\u003cp\u003e\n  \u003ch1 align=\"center\"\u003e\u003cb\u003e\u003ca href='https://rogue-master.net'\u003e\u003cimg src=\"https://lh3.googleusercontent.com/d/1EqKVTt3clsfM8pFoZVfl4kPzm9oNqWkY\" width=\"40%\"\u003e\u003c/a\u003e\u003c/b\u003e\u003c/h1\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e\u003ca href='https://discord.gg/gF2bBUzAFe' target='_blank'\u003e\u003cimg src='https://lh3.googleusercontent.com/d/1Ytf8DOQZuFhzWUL2Vm-TTPVrdwRt5wi-' alt='Discord' title='Discord'\u003e\u003c/a\u003e\n\u0026nbsp;\u003ca href='https://github.com/RogueMaster/flipperzero-firmware-wPlugins/releases/latest' target='_blank'\u003e\u003cimg src='https://lh3.googleusercontent.com/d/1DvytrGJms7OaLDrYDA8hTawwqdoi5rDo' alt='Firmware GitHub' title='Firmware GitHub'\u003e\u003c/a\u003e\n\u0026nbsp;\u003ca href='https://www.patreon.com/RogueMaster?filters[tag]=Latest%20Release' target='_blank'\u003e\u003cimg src='https://lh3.googleusercontent.com/d/1iYQlRQXM7nA4IAdcPwvcKRSTCMoi8tug' alt='Latest PATREON Release' title='Latest PATREON Release'\u003e\u003c/a\u003e\n\u0026nbsp;\u003ca href='https://github.com/RogueMaster/awesome-flipperzero-withModules' target='_blank'\u003e\u003cimg src='https://lh3.googleusercontent.com/d/1gjui0-UZNerG13PUblXjmr1YaSAjIf2k' alt='More Research / Assets' title='More Research / Assets'\u003e\u003c/a\u003e\u003c/h1\u003e\n\n# [Support Me On Patreon to get the best assets updated frequently!](https://www.patreon.com/RogueMaster)\n## [This repo is an improved fork of the OG Evil Portal app by bigbrodude6119!](https://github.com/bigbrodude6119/flipper-zero-evil-portal)\n- I have made some changes to file names and accepted some PRs that were open.\n- Also gave it a more descriptive application.fam file.\n- [Fixed to compile on 0.94.1 (By RogueMaster)](https://github.com/RogueMaster/flipperzero-evil-portal/commit/85df877fc6841db1d67adf3d0d4e822412da468f)\n- [Fixed to compile on OFW + Unleashed (By RogueMaster)](https://github.com/RogueMaster/flipperzero-evil-portal/commit/7a01dc9e88f9979a432b43fb742b4fe849c6357b)\n\n# Flipper Zero Evil Portal\n\nAn evil captive portal Wi-Fi access point using the Flipper Zero and Wi-Fi dev board\n\n## About\n\n**This project is a work in progress.**\n\nThis project will turn your Wi-Fi dev board into an open access point. When users try to connect to this access point they will be served a fake login screen. User credentials are sent to the Flipper and logged on the SD card.\n\n## Disclaimer\n\nI am not a C developer and I am using this project as a way to learn more about esp32, flipper zero and, C programming.\n\nThis program is for educational purposes only.\n\n## Getting Started\n\nYou will need to manually flash the Wi-Fi dev board.\n\n### Install pre-built app on the flipper\n\nGo to the releases section on this repo and download and extract either the `ofw-evil_portal.fap.zip` file or the `unleashed-evil_portal.fap.zip` file depending on if you are using the official firmware (ofw) or the unleashed firmware. These files will contain the `evil_portal.fap` file for your firmware.\n\nYou will also need to download and extract the `evil_portal_sd_folder.zip` folder. This will contain necessary files for the app to run.\n\nPut the `evil_portal.fap` file into the `apps/GPIO/` folder on your Flipper SD card.\n\nPut the `evil_portal` folder into the `apps_data` folder.\nThis is an example of your Flipper SD card if done correctly.\n\n```\napps/\n  GPIO/\n    evil_portal.fap\napps_data/\n  evil_portal/\n    ap.config.txt\n    index.html\n    logs/\n      \u003cempty\u003e\n```\n\nYou should be able to see the `[ESP32] Evil Portal` app on your flipper zero now.\n\nIf you want to create your own `index.html` file keep in mind that there is a limit of 4000 characters for the file. I plan to increase this later but I ran into some issues with larger files.\n\n## Installing/flashing the Wi-Fi dev board\n\nIf you've already flashed your Wi-Fi dev board with the Marauder firmware or something else you will need to erase it before installing the new firmware here. Follow [the guide here](#erasing-firmware) for that.\n\nFollow the steps below to flash the Wi-Fi dev board with the evil portal firmware via Windows. The instructions below are for the Flipper Zero Wi-Fi Wrover Development Module (**ESP32-S2**), you may have to adjust the steps for your specific board:\n\n1. Download and install the Arduino IDE from [here][link-arduino].\n2. Download zip/clone dependency [AsyncTCP][link-asynctcp] to file.\n3. Download zip/clone dependency [ESPAsyncWebServer][link-espasyncwebserver] to file.\n4. Unzip both dependencies to your Arduino library folder.\n   - On Windows this is usually `C:\\Users\\\u003cusername\u003e\\Documents\\Arduino\\libraries`.\n5. Go to the releases section on this repo and download the `EvilPortal.ino` file, open it with Arduino IDE.\n6. Go to `File \u003e Preferences` and paste the following two URL's into the `Additional Boards Manager URLs` field:\n   ```\n   https://dl.espressif.com/dl/package_esp32_index.json\n   https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json\n   ```\n7. Go to `Tools \u003e Board \u003e Boards Manager...` and search for `esp32` and install `esp32 by Espressif Systems`.\n8. Go to `Tools \u003e Board` and select `ESP32S2 Dev Module`.\n9. On your ESP32-S2 Wi-Fi module, hold the BOOT button.\n10. Connect your ESP32-S2 to your computer, keep holding the BOOT button (holding for just 3-5 seconds and releasing may be fine, continuously holding worked better for me).\n11. Go to `Tools \u003e Port` and select the port that appeared when you connected your ESP32-S2.\n12. Click the \"Upload\" button in the top left corner of the Arduino IDE.\n13. On success, you will see:\n    ```\n    Hash of data verified.\n    Leaving...\n    WARNING: ESP32-S2 (revision v0.0) chip was placed into download mode...\n    ```\n14. Plug in the Wi-Fi Dev board to the flipper, press the reset button on the Wi-Fi dev board and you should now see a solid blue light.\n\n## Installing/flashing an ESP32 Wroom board\n\nReddit user dellycem [compiled binaries](https://old.reddit.com/r/flipperzero/comments/14ni93r/i_made_a_evil_portal_app_for_the_fz_wifi_dev_board/jqd42fi/?context=3) for the ESP32 Wroom board if you would like to use that instead of the Wi-Fi devboard.\n\n1. Download the bin files from [this link](https://wetransfer.com/downloads/4d3dd914f2df43dc6c84efa452043f4220230702094742/33a478)\n2. Go to [ESPWebTool](https://esp.huhn.me/) and get your board connected.\n3. Add each of the bin files at the following locations\n   ```\n   EvilPortal.bootloader.bin - 0x1000\n   EvilPortal.partitions.bin - 0x8000\n   boot_app0.bin - 0xe000\n   EvilPortal.bin - 0x10000\n   ```\n4. Press the program button and wait while your board is flashed.\n5. Once complete, hook up the 3.3v, GND, RX0, and TX0 pins to the flipper zero. Remember that the RX/TX pins should go to the opposite pins on the flipper zero. RX -\u003e TX, TX -\u003e RX.\n\n## Usage\n\nPlug in the Wi-Fi Dev board to the flipper.\n\nOpen the app on the Flipper and press `Start portal` on the main menu. After a few seconds you should start to see logs coming in from your Wi-Fi dev board and the AP will start and the LED will turn green.\n\nThe AP will take the name that is in the `ap.config.txt` file located on your Flipper in the `apps_data/evil_portal/` folder.\n\nWhen you connect to the AP a web page will open after a few seconds. This web page contains the HTML located in the `index.html` file located on your Flipper in the `apps_data/evil_portal/` folder.\n\nYou can stop the portal by pressing `Stop portal` on the main menu. The LED should turn blue.\n\nYou can manually save logs using the `Save logs` command. Logs will be stored in the `logs` folder that is in your `apps_data/evil_portal/` folder.\n\nLogs will automatically be saved when exiting the app or when the current log reaches 4000 characters.\n\n## Building for different firmware\n\nIf you are not using the official flipper zero firmware or the unleashed firmware you can build the .fap file yourself by following [these instructions](https://github.com/flipperdevices/flipperzero-firmware/blob/dev/documentation/AppsOnSDCard.md).\n\nNote that you will need to use the firmware repo that you wish to build for.\n\nYou can also download builds for each firmware via [flipc](https://flipc.org/bigbrodude6119/flipper-zero-evil-portal?branch=main\u0026root=flipper%2Fflipper-evil-portal).\n\n## Erasing firmware \u003ca name=\"erasing-firmware\"\u003e\u003c/a\u003e\n\nAssuming you have the Flipper Zero Wi-Fi Wrover Development Module (**ESP32-S2**):\n\n1. Install [Python][link-python].\n2. Open a command terminal as an administrator:\n   - On Windows press ⊞Win+R, type \"cmd\", and press CTRL+SHIFT+ENTER.\n3. In the terminal type the following to install [esptool][link-esptool] via Python package manager:\n   ```\n   pip install esptool\n   ```\n4. Install [setuptools][link-setuptools] dependencies:\n   ```\n   pip install setuptools\n   ```\n5. Enter the following command into your terminal, do not run it yet:\n   ```\n   python -m esptool --chip esp32s2 erase_flash\n   ```\n6. On your ESP32-S2 Wi-Fi module, hold the BOOT button.\n7. Connect your ESP32-S2 to your computer, keep holding the BOOT button.\n8. In your terminal press enter to run the command from step 5.\n9. When successful you will get the message `Chip erase completed successfully in ___s` (time in seconds suffixed with \"s\").\n10. Unplug/reset your board.\n\n## Issues\n\nIf you run into any issues make sure that you have the required files set up on the Flipper `apps_data` folder on the Flipper SD card.\n\nLogs will not be saved if there is no `logs` folder in `apps_data/evil_portal/`.\n\nIf the AP won't start or you have other issues try pressing reset on the Wi-Fi dev board, waiting a few seconds, and pressing `Start portal` on the main menu.\n\nIt is important to give the devboard some time to load the html files from the Flipper.\n\nIf you have the Marauder firmware on your dev board you may need to enable `Erase All Flash Before Sketch Upload` before flashing.\n\nSome users are reporting that the captive portal login does not open on some Android phones.\n\n## Todo\n\nI plan on working on this in my free time. Here is my todo list.\n\n- Support for multiple portals\n- Enter AP name on the Flipper\n- Add a config file for general app settings\n- Create cleaner log files that are easier to read\n- Clean up code \u0026 implement best practices\n\n## License\n\nDistributed under the MIT License. See `LICENSE.txt` for more information.\n\n## Acknowledgments\n\nI was only able to create this using the following apps as examples\n\n- [flipperzero-wifi-marauder](https://github.com/0xchocolate/flipperzero-wifi-marauder)\n- [UART_Terminal](https://github.com/cool4uma/UART_Terminal)\n- [flipper-zero-fap-boilerplate](https://github.com/leedave/flipper-zero-fap-boilerplate)\n- [Create Captive Portal Using ESP32](https://iotespresso.com/create-captive-portal-using-esp32/)\n\n## Contact me\n\nYou can message me on my reddit account bigbrodude6119\n\n\u003c!-- LINKS --\u003e\n\n[link-arduino]: https://www.arduino.cc/en/software\n[link-asynctcp]: https://github.com/me-no-dev/AsyncTCP\n[link-espasyncwebserver]: https://github.com/me-no-dev/ESPAsyncWebServer\n[link-esptool]: https://pypi.org/project/esptool/\n[link-python]: https://www.python.org/downloads/\n[link-setuptools]: https://pypi.org/project/setuptools/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froguemaster%2Fflipperzero-evil-portal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froguemaster%2Fflipperzero-evil-portal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froguemaster%2Fflipperzero-evil-portal/lists"}