Visor: an independent Ray-Ban Meta glasses client

Requirements & limits

• Prerequisites: Reviewed just after release v1.3.1 (2026-10-18). README targets Ray-Ban Meta (Gen 2) tested on firmware 72387580077200100; other Meta glasses are untested. It needs an Android 10+ phone, a Meta account using password or email-code login (passkeys do not work) and, for the assistant, an Anthropic or OpenAI-compatible API key. The glasses accept one session at a time, so Visor and the Meta AI app displace each other.
• Prerequisites: Setup makes Visor the glasses’ owner app through Meta’s login and ownership-receipt services, so it still depends on a Meta account and Meta servers for setup, frame style and language packs. Source builds need three client tokens from the official Meta AI app, which the repository does not include; without them the app builds but login and ownership fail. Release builds read them from CI secrets.
• Prerequisites: Building needs JDK 21 and the Android SDK with platform 37. CI builds a debug APK with Gradle, and tagged releases publish a signed APK with a SHA-256 file; README lists the release certificate fingerprint. Modules separate wire format and ciphers, transport, session, identity, media, settings and the assistant, which stands in for Meta’s server with Claude or an OpenAI-compatible model.
• Testing evidence: There are no test suites: CONTRIBUTING asks for hardware trials and wire.log excerpts for protocol changes, and CLAUDE.md says the app works on real glasses as of 2026-10-05. The wiki marks unconfirmed facts and lists open questions, including unread payloads and model-specific values; CLAUDE.md also refers to a desktop Python client snapshot that the repository does not contain.
• License: Visor is AGPL-3.0 and states it is unaffiliated with Meta or EssilorLuxottica; Meta’s services, app tokens, firmware and trademarks keep their own terms. CONTRIBUTING forbids getting unsigned software past the glasses’ signature checks. Claude is one selectable assistant backend, and the repository’s CLAUDE.md is a contributor guide.

About this entry

The description was reviewed against primary sources.

Report an outdated entry ↗Suggest a translation fix ↗

Primary sources

1. README.md GitHub · macedonga/visor · Revision 8caaa12
2. CLAUDE.md GitHub · macedonga/visor · Revision 8caaa12
3. CONTRIBUTING.md GitHub · macedonga/visor · Revision 8caaa12
4. SECURITY.md GitHub · macedonga/visor · Revision 8caaa12
5. LICENSE GitHub · macedonga/visor · Revision 8caaa12
6. app/build.gradle.kts GitHub · macedonga/visor · Revision 8caaa12
7. .github/workflows/build.yml GitHub · macedonga/visor · Revision 8caaa12
8. .github/workflows/release.yml GitHub · macedonga/visor · Revision 8caaa12
9. core/protocol/src/main/kotlin/com/macedonga/visor/core/protocol/Framing.kt GitHub · macedonga/visor · Revision 8caaa12
10. core/protocol/src/main/kotlin/com/macedonga/visor/core/protocol/Cipher.kt GitHub · macedonga/visor · Revision 8caaa12
11. core/assistant/src/main/kotlin/com/macedonga/visor/core/assistant/Brain.kt GitHub · macedonga/visor · Revision 8caaa12
12. https://github.com/macedonga/visor/wiki/Home/7358c5a1c39a6354d2170f89133b184f7f2b82e7
13. https://github.com/macedonga/visor/wiki/Protocol-overview/7358c5a1c39a6354d2170f89133b184f7f2b82e7
14. https://github.com/macedonga/visor/wiki/Meta-login-and-ownership/7358c5a1c39a6354d2170f89133b184f7f2b82e7
15. https://github.com/macedonga/visor/wiki/Open-questions/7358c5a1c39a6354d2170f89133b184f7f2b82e7