p5.ble.js

This project is currently in development.

A Javascript library that enables communication between your BLE devices and your p5 sketch. With p5.ble.js, you can request and connect to nearby Bluetooth devices, read/write Bluetooth characteristics, start/stop notifications.

The library is supported by code examples, tutorials that cover many popular Bluetooth LE devices.

p5.ble.js is inspired by p5.serialport, p5.js, Web Bluetooth API, and Processing Serial Library.

Usage

Download the minified, or use the online version and add it to the head section of your HTML document:

<script src="https://github.com/ITPNYU/p5.ble.js/raw/master/p5.ble.min.js" type="text/javascript"></script>

or

<script src="https://unpkg.com/p5ble@0.0.7/dist/p5.ble.js" type="text/javascript"></script>

Browser compatibility

p5.ble.js is based on Web Bluetooth API, checkout Web Bluetooth API's browser compatibility and implementation status.

Learning

• ITP Physical Computing Lab: Bluetooth LE and p5.ble
• p5.ble Workshop Slides, examples
• Arduino Project Hub Getting Started with p5.ble.js Using Arduino Nano 33 BLE

Resources

• Getting Started
• API Reference
• Examples
• Tutorials

Examples

You can find a collection of examples in the examples folder in this repository.

Contributing

See CONTRIBUTING

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Yining Shi 💻 💡 📖 🐛

Jingwen Zhu 💡 📖 🐛 📝 ✅

Tom Igoe 💡 📖 🐛 📝 ✅

Cédric 💻

Sandeep Mistry 💡

This project follows the all-contributors specification. Contributions of any kind welcome!