{"id":29308548,"url":"https://github.com/siddharthsinghkumar/bluetooth-esp32-controller","last_synced_at":"2025-07-11T12:02:35.296Z","repository":{"id":302910299,"uuid":"1013915032","full_name":"Siddharthsinghkumar/Bluetooth-ESP32-Controller","owner":"Siddharthsinghkumar","description":"📡 A simple Android app and ESP32 firmware for Bluetooth-based wireless control — built as a proof of concept for a larger IoT integration project.2025","archived":false,"fork":false,"pushed_at":"2025-07-04T17:35:52.000Z","size":191,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-04T18:39:59.390Z","etag":null,"topics":["android-application","arduino","automation","bluto","embedded","esp32","iot","microcontroller","proof-of-concept","wireless"],"latest_commit_sha":null,"homepage":"","language":"Java","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/Siddharthsinghkumar.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,"zenodo":null}},"created_at":"2025-07-04T17:25:27.000Z","updated_at":"2025-07-04T17:41:57.000Z","dependencies_parsed_at":"2025-07-04T18:51:09.047Z","dependency_job_id":null,"html_url":"https://github.com/Siddharthsinghkumar/Bluetooth-ESP32-Controller","commit_stats":null,"previous_names":["siddharthsinghkumar/bluetooth-esp32-controller"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Siddharthsinghkumar/Bluetooth-ESP32-Controller","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddharthsinghkumar%2FBluetooth-ESP32-Controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddharthsinghkumar%2FBluetooth-ESP32-Controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddharthsinghkumar%2FBluetooth-ESP32-Controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddharthsinghkumar%2FBluetooth-ESP32-Controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Siddharthsinghkumar","download_url":"https://codeload.github.com/Siddharthsinghkumar/Bluetooth-ESP32-Controller/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddharthsinghkumar%2FBluetooth-ESP32-Controller/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264032310,"owners_count":23546809,"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":["android-application","arduino","automation","bluto","embedded","esp32","iot","microcontroller","proof-of-concept","wireless"],"created_at":"2025-07-07T07:12:34.838Z","updated_at":"2025-07-07T07:12:35.538Z","avatar_url":"https://github.com/Siddharthsinghkumar.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📡 Bluetooth-ESP32-Controller\n\nA simple proof-of-concept project to demonstrate wireless communication between an **Android app** and an **ESP32 microcontroller** over Bluetooth.  \nThe Android app sends simple control commands, and the ESP32 receives and processes them. This project serves as a foundation for future IoT and automation integrations.\n\n---\n\n## 🚀 Features\n\n- 📱 Android app built in Android Studio to send Bluetooth commands (`ON`, `OFF`).\n- 🔌 ESP32 receives commands using Bluetooth Serial and prints them over Serial Monitor.\n- 🔧 Expandable for controlling LEDs, motors, relays, or other devices.\n- 📸 Includes photos of the project in action.\n\n---\n\n## 🔨 Project Structure\n\n```\nBluetooth-ESP32-Controller/\n├── android-app/               # Android Studio project (Bluetooth sender app)\n├── esp32-firmware/             # ESP32 Arduino sketch (Bluetooth receiver)\n├── images/                     # Demo images of the working setup\n├── README.md                    # This file\n├── LICENSE                      # MIT License (optional)\n└── .gitignore                   # Ignore build and IDE files\n```\n\n---\n\n## 📲 Android App Setup\n\n1. Open the `android-app/` folder in Android Studio.\n2. Update the **Bluetooth MAC Address** in `MainActivity.java`:  \n   ```java\n   private static final String DEVICE_ADDRESS = \"XX:XX:XX:XX:XX:XX\"; // Replace with your ESP32's address\n   ```\n3. Build and install the app on your Android phone.\n4. Pair your phone with the ESP32 via Bluetooth settings.\n5. Run the app and press the **\"Turn ON\"** and **\"Turn OFF\"** buttons to send commands.\n\n---\n\n## 🔌 ESP32 Firmware Setup\n\n1. Open `esp32-firmware/esp32-bluetooth.ino` in the Arduino IDE.\n2. Select your ESP32 board (e.g., ESP32 Dev Module).\n3. Upload the sketch to your ESP32.\n4. Open the Serial Monitor to view received messages.\n\n---\n\n## 📸 Demo\n\n| ESP32 Setup | Working Demo |\n|-------------|--------------|\n| ![ESP32](images/esp32-setup.jpg) | ![Working Demo](images/bluetooth-working.jpg) |\n\n*(Replace with your actual image file names in the `/images` folder.)*\n\n---\n\n## 🔮 Future Plans\n\n- Add real-world device control (e.g., LED, relay).\n- Implement bidirectional communication.\n- Create a polished Android UI.\n- Expand to Wi-Fi and cloud integration.\n\n---\n\n## 🛡️ License\n\nThis project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙌 Acknowledgements\n\n- ESP32 BluetoothSerial library\n- Android BluetoothAdapter documentation\n- Inspired by personal IoT automation needs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddharthsinghkumar%2Fbluetooth-esp32-controller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiddharthsinghkumar%2Fbluetooth-esp32-controller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddharthsinghkumar%2Fbluetooth-esp32-controller/lists"}