This project turns any modern Android phone into a powerful, network-accessible Bluetooth Low Energy (BLE) gateway. It exposes your phone's native BLE capabilities through a high-performance gRPC API, allowing any computer on your network to control it remotely.
Use this to automate BLE testing, create remote-controlled device dashboards, or build IoT solutions without dedicated hardware.
- Full Remote Control: Perform BLE scans, connect, read, write, and subscribe to notifications with a simple script on your PC.
- Modern & Robust: Built with Kotlin, Coroutines, and Flow, running inside a resilient Android Foreground Service.
- Clear API Contract: The entire API is defined in a single, easy-to-understand
ble.protofile.
The Android app runs a lightweight gRPC server in the background. When a client (such as a Python script) sends a command (e.g., "scan for devices"), the app's server translates this command into a native Android BLE operation. The results are then streamed back to the client over your local Wi-Fi network.