> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mentraglass.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mentra Live

> Build mobile apps that connect directly to Mentra Live over Bluetooth.

The Mentra Bluetooth SDK is the base SDK for building mobile apps that control Mentra Live directly over Bluetooth. It gives Android, iOS, and React Native apps access to scanning, pairing, device status, microphone audio, camera capture, speaker playback, streaming, Wi-Fi, and hardware events.

Use this SDK when your app owns the mobile experience and needs a direct phone-to-glasses connection.

In Summer 2026, we'll release MentraOS 3.0, a new SDK for building apps that run on the phone. Learn more in the [MentraOS Roadmap June blogpost](https://mentraglass.com/blogs/blog/mentra-roadmap-update-moving-to-miniapps-on-the-phone).

## Packages

| Platform            | Package                            | Import                                             |
| ------------------- | ---------------------------------- | -------------------------------------------------- |
| Android             | `com.mentraglass:bluetooth-sdk`    | `import com.mentra.bluetoothsdk.*`                 |
| iOS                 | `MentraBluetoothSDK` Swift package | `import MentraBluetoothSDK`                        |
| React Native / Expo | `@mentra/bluetooth-sdk`            | `import BluetoothSdk from '@mentra/bluetooth-sdk'` |

## What You Can Build

* Native Android, iOS, or React Native apps that scan for and connect to Mentra Live.
* Apps that receive button, touch, swipe, head-up, battery, Wi-Fi, hotspot, stream, photo, audio, and SDK log events.
* Apps that control Mentra Live features such as gallery mode, camera settings, speaker playback, RGB LEDs, Wi-Fi, hotspot, microphone, camera, and streaming.
* Photo upload to your own webhook and RTMP, SRT, or WebRTC streaming to your own ingest endpoint. The starter kit also includes optional local demo helpers for trying these flows on a LAN.

## Requirements

* The Bluetooth SDK and Mentra Live glasses software must use the same release version. The latest matching pair is `0.1.20`.
* A physical Android phone or iPhone for real Bluetooth testing.
* Android min SDK `28` or newer.
* iOS deployment target `15.1` or newer.
* React Native / Expo apps must use a development build or production native build. Expo Go cannot load the native SDK.
* Bluetooth permissions, plus Android location permission where BLE scanning requires it.

<Warning>
  Bluetooth connection alone does not confirm version compatibility. Before testing SDK features, [update Mentra Live to the glasses software matching your SDK version](/mentra-live/software-update). An app using Bluetooth SDK `0.1.20` must use the matching Mentra Live `0.1.20` software release.
</Warning>

<CardGroup cols={2}>
  <Card title="Update Mentra Live" icon="download" href="/mentra-live/software-update">
    Install the glasses software that matches your Bluetooth SDK release.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/mentra-live/quickstart">
    Install the SDK, connect to Mentra Live, and read glasses status.
  </Card>

  <Card title="Example Apps" icon="mobile" href="/mentra-live/examples">
    Run the Android, iOS, and React Native starter apps from a fresh clone.
  </Card>

  <Card title="API Reference" icon="book" href="/mentra-live/api-reference">
    Review lifecycle, commands, events, status fields, and Mentra Live behavior.
  </Card>

  <Card title="Troubleshooting" icon="circle-question" href="/mentra-live/troubleshooting">
    Fix native build, permission, scan, stream, and Expo issues.
  </Card>
</CardGroup>