Skip to main content
The fastest way to get started with the Mentra Bluetooth SDK is to run one of the complete example apps in the Mentra Bluetooth SDK Starter Kit. Choose Android, iOS, or React Native / Expo and connect to Mentra Live without first adding the SDK to your own app.

Open the Starter Kit on GitHub

Browse the example apps and source code.
Use a physical phone for Bluetooth testing. Simulators and emulators do not provide the real Bluetooth path.

​
1. Clone the Starter Kit

The examples include the OTA flow required to install the Mentra Live glasses software that matches their Bluetooth SDK version. For the current 0.1.21-beta.5 builds and step-by-step update instructions, see Update Mentra Live.

​
2. Run an Example App

​
Android

The Android example is a Kotlin / Jetpack Compose app. It installs the SDK as com.mentraglass:bluetooth-sdk.

​
iOS

Choose a physical iPhone as the run destination in Xcode. The iOS example is a SwiftUI app that installs the MentraBluetoothSDK Swift package.

​
React Native / Expo

The React Native example installs @mentra/bluetooth-sdk and demonstrates the same Device, Camera, Stream, System, and Console flows as the native examples.

​
3. Connect and Explore

Open the example app, scan for Mentra Live, select your glasses, and connect. The examples demonstrate:
  • Connecting, disconnecting, and reconnecting to a saved/default device.
  • Checking for and installing the glasses software release that matches the SDK.
  • Reading typed glasses and Bluetooth status snapshots.
  • Handling button, touch, swipe, head-up, battery, Wi-Fi, hotspot, stream, photo, video upload, audio, and SDK log events.
  • Controlling gallery mode, capture settings, speaker playback, RGB LEDs, Wi-Fi, hotspot, microphone, camera, and streaming.
  • Running glasses-to-phone photo and streaming demos.

​
Optional Local Media and Streaming Helper

The Camera and Stream screens default to a glasses-to-phone flow. You do not need a separate server for that default path. Use the helper only when you turn on Use cloud server in the example app and want to test an external endpoint without deploying your own media upload webhook or streaming server. From the repository root, run:
Paste the printed LAN /upload, RTMP, SRT, or WHIP URL into the corresponding example screen. If Docker is unavailable, the helper starts the media upload webhook and skips streaming with a warning.
Do not use localhost in the app. The glasses, phone, and computer must be on a network where the glasses can reach the printed LAN address.

​
Add the SDK to Your App

Ready to integrate the SDK into an existing project? Continue to Build from Scratch.