macedonga / visor

Visor is an Android app for Ray-Ban Meta glasses that replaces the Meta AI app. It speaks the glasses' own protocol over Bluetooth and Wi-Fi Direct, keeps your photos on your phone, and answers "Hey Meta" with a model you choose.
Visor is an independent project. It is not affiliated with, endorsed by or sponsored by Meta Platforms or EssilorLuxottica.
## What it does
- **Home.** A 3D model of your pair, lit by a light that shows their state: connected, charging, asleep, recording, out of reach. Under it, the glasses' battery and the case's, free space, volume, temperature and your latest photos.
- **Gallery.** Imports photos and videos over Wi-Fi Direct, on its own when the glasses charge or when you ask. Live photos become Motion Photos. Everything goes to `Pictures/Visor` and `Movies/Visor`.
- **Live view.** The glasses' camera on your phone, with recording, an instant replay of the last minutes, snapshots, RTMP broadcast and Live AI.
- **Assistant.** "Hey Meta" goes to your own model: Claude, or any OpenAI-compatible endpoint. The glasses read the answer in their own voice. Every conversation is kept on the phone in a diary, and you can continue one from the app.
- **Notifications.** Message notifications go to the glasses, which announce them with the sender's name from your contacts.
- **Settings.** Every setting the glasses have, the way the Meta app shows them, plus an Advanced section with all the rest, assistant language packs and the firmware's feature flags.
- **Outside the app.** A home screen widget, a Quick Settings tile, launcher shortcuts and a Live Update notification while the Live view runs.
## What it sends, and where
Visor has no server of its own, no analytics and no crash reporting. It connects to:
- Meta, during setup: the login (`accounts.meta.com`) and the ownership receipt that makes Visor the owner app of your glasses (`graph.facebook-hardware.com`).
- Meta, when it needs to: the frame style and lens colour of your pair, and assistant language packs (`ar-genai.graph.meta.com`).
- The model provider you set for the assistant, with your own API key.
- The RTMP server you enter, when you broadcast from the Live view.
- GitHub, twice a day: the latest release, to tell you when there is a new version (`api.github.com`). Turn it off in Settings, About.
Everything else stays between the phone and the glasses.
## Requirements
- Ray-Ban Meta (Gen 2). Visor is tested on firmware 72387580077200100. Other Meta glasses are not tested.
- An Android phone with Android 10 or later.
- A Meta account, for setup. Log in with a password or an email code. Passkeys do not work.
- For the assistant: an API key from Anthropic or from an OpenAI-compatible service.
## Install
1. Download `visor- .apk` from the latest release.
2. Compare its SHA-256 with the `.sha256` file next to it.
3. Install the APK. Android asks you to allow installs from your browser or file manager.
4. Open Visor and follow the setup: permissions, Meta login, pairing, the