{"id":15163036,"url":"https://github.com/cloofsiu/esp32-mac-address-scanner","last_synced_at":"2026-02-19T12:33:17.011Z","repository":{"id":251565577,"uuid":"837437179","full_name":"cloofsiu/ESP32-mac-address-scanner","owner":"cloofsiu","description":"ESP32: mac-address-scanner","archived":false,"fork":false,"pushed_at":"2024-08-07T03:11:48.000Z","size":11378,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T08:18:44.989Z","etag":null,"topics":["esp32","macaddress","robotics"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloofsiu.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":"2024-08-03T01:49:35.000Z","updated_at":"2024-08-07T03:11:50.000Z","dependencies_parsed_at":"2024-08-07T06:49:42.521Z","dependency_job_id":null,"html_url":"https://github.com/cloofsiu/ESP32-mac-address-scanner","commit_stats":{"total_commits":23,"total_committers":1,"mean_commits":23.0,"dds":0.0,"last_synced_commit":"b10262b0118b131a9fe91928dc482875f6a672a6"},"previous_names":["cloofsiu/esp32-mac-address-scanner"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloofsiu%2FESP32-mac-address-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloofsiu%2FESP32-mac-address-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloofsiu%2FESP32-mac-address-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloofsiu%2FESP32-mac-address-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloofsiu","download_url":"https://codeload.github.com/cloofsiu/ESP32-mac-address-scanner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247801170,"owners_count":20998339,"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":["esp32","macaddress","robotics"],"created_at":"2024-09-27T02:02:33.682Z","updated_at":"2025-10-19T22:13:52.441Z","avatar_url":"https://github.com/cloofsiu.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Repository: ESP32 MAC Address Scanner\n\n\n\nWelcome to the ESP32 MAC Address Sniffer project! This project is designed to help you scan and display MAC addresses of Bluetooth Low Energy (BLE) devices using an ESP32-WROOM module. The data is presented on a 1602 LCD module, making it a handy tool for robotics applications and BLE device management.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"doc/logo.png\" alt=\"Logo\"\u003e\n\u003c/p\u003e\n\n\u003cbr/\u003e\n\n## Components Used\n\n- [ESP32-WROOM](https://github.com/user-attachments/assets/22abd3a0-e08a-4ddc-9715-9f2bdde51bbb): The core microcontroller for this project.\n- [1602 LCD Module](https://github.com/user-attachments/assets/62be00a6-b8b0-4ccc-8da5-08ef50e21eca): For displaying the scanned device information.\n- Two Breadboards: For cable expansion and easy prototyping.\n- Wires and Connectors: To connect all components together.\n  \n\u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/22abd3a0-e08a-4ddc-9715-9f2bdde51bbb\" width=\"200\"\u003e\n\n\u003cimg src=\"https://github.com/user-attachments/assets/62be00a6-b8b0-4ccc-8da5-08ef50e21eca\" width=\"300\"\u003e\n\u003c/p\u003e\n\n\u003cbr/\u003e\n\n## Features\n\n**BLE Scanning:** Scans for nearby BLE devices and retrieves their MAC addresses and names.\n\u003cbr/\u003e\n**LCD Display:** Displays the device information on a 1602 LCD module.\n\u003cbr/\u003e\n**Button Navigation:** Use the BOOT button to cycle through the list of detected devices.\n\n\n\u003cbr/\u003e\n\n## Demo video\n\n[![Demonstration Youtube video](https://img.youtube.com/vi/rXiXpg-fihc/0.jpg)](https://www.youtube.com/watch?v=rXiXpg-fihc)\n\n\u003cbr/\u003e\n\n## How to Use\n\n**1. Hardware Setup:**\n\n- Connect the ESP32-WROOM to the breadboards.\n- Connect the 1602 LCD module to the ESP32 using an I2C interface.\n- Connect the BOOT button to the ESP32.\n\n**2. Software Setup:**\n- Clone this repository.\n- Upload the provided [code](code/ESP32_mac-scanner.h) to your ESP32 using the Arduino IDE or another suitable development environment.\n- Make sure to install the necessary libraries ([Wire.h](https://github.com/esp8266/Arduino/blob/master/libraries/Wire/Wire.h), [LiquidCrystal_I2C.h](https://www.arduinolibraries.info/libraries/liquid-crystal-i2-c), [BLEDevice.h](https://github.com/nkolban/ESP32_BLE_Arduino/blob/master/src/BLEDevice.h)).\n\n**3. Running the Scanner:**\n- Power up the ESP32.\n- The ESP32 will scan for BLE devices for 5 seconds.\n- Detected devices will be displayed on the LCD. Use the BOOT button to navigate through the list.\n\n\u003cbr/\u003e\n\n## Applications in Robotics\n\nThis MAC Address Scanner Sniffer can be particularly useful in robotics for identifying and managing BLE devices such as sensors and controllers. It simplifies the process of troubleshooting and device management, making it an essential tool for any robotics enthusiast.\n\n\u003cbr/\u003e\n\n## Contributing\n\nFeel free to fork this repository and contribute by adding new features or improving the existing code. Pull requests are welcome!\n\n\u003cbr/\u003e\n\n## License\n\nThis project is licensed under the MIT License. (see [LICENSE](LICENSE) file for details)\n\n\u003cbr/\u003e\n\n## Contact\n\nFor any questions or suggestions, please feel free to contact me via GitHub or email cloofsiu@gmail.com\n\n\u003cbr/\u003e\n\n\n\n\u003cbr/\u003e\nHappy building, \n\n **Cloof Siu**\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloofsiu%2Fesp32-mac-address-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloofsiu%2Fesp32-mac-address-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloofsiu%2Fesp32-mac-address-scanner/lists"}