raphael / web-bluetooth-polyfill

Windows 10 Web Bluetooth Polyfill

Windows 10 Web Bluetooth Polyfill

The Polyfill enables Web Bluetooth in Chrome on Windows 10.

Installation

1. You need to help Windows 10 Creators Update (build 15063) or newer
2. Clone this repo: git clone https://github.com/urish/web-bluetooth-polyfill
3. Open Chrome Extensions pane (chrome://extensions/) and enable "Developer Mode" (there is a checkbox on top of the page)
4. Click the "Load unpacked extension..." button
5. Choose the extension folder inside the cloned repo
6. Download the latest BLEServer and unpack it inside C:\Program Files (x86)\Web Bluetooth Polyfill
7. Run C:\Program Files (x86)\Web Bluetooth Polyfill\register.cmd to register the Native Messaging server

That's it! Enjoy Web Bluetooth on Windows :-)

Current State

TL;DR - Should work out of the box with most Web Bluetooth apps.

Most of the functionality is already there, but there might be slight differences between the current implementation and the spec. Device Chooser UI is still missing, so the first matching device is picked up automatically. Check out the list of issues to see what is currently still missing. Pull Requests are very welcome!

List of API methods / events and their implementation status:

• requestDevice
• Device Chooser UI (#1)
• gatt.connect
• gatt.disconnect
• gattserverdisconnected event (#2)
• serviceadded / servicechanged / serviceremoved events (#3)
• getPrimaryService / getPrimaryServices
• getCharacteristic / getCharacteristics
• writeValue
• readValue
• startNotifications / characteristicvaluechanged event
• stopNotifications (#4)
• getIncludedService / getIncludedServices (#5)
• getDescriptor / getDescriptors (#6)