Skip to main content

ASG Client Documentation

The ASG (Android Smart Glasses) Client is the Android application that runs on smart glasses devices, providing the core functionality for MentraOS integration.

Overview

ASG Client serves as the bridge between:

  • Physical hardware (buttons, camera, sensors)
  • MentraOS mobile app (via Bluetooth)
  • MentraOS Cloud (via the mobile app relay)

Currently, the primary supported device is Mentra Live.

Key Features

📸 Camera System

  • Photo capture with configurable button modes
  • Video recording (in development)
  • Media upload queue with offline support

📹 RTMP Streaming

  • Live video streaming to custom RTMP servers
  • Keep-alive mechanism with 60-second timeout
  • ACK-based reliability system

📶 Network Management

  • WiFi connection management
  • Hotspot creation for setup
  • Network state monitoring

🔵 Bluetooth Communication

  • BLE message parsing from mobile app
  • Status updates to phone
  • Command processing

🎮 Hardware Integration

  • Button press detection (camera button)
  • Swipe gesture recognition
  • Battery status monitoring

Architecture

The client uses a modular architecture with:

  • Manager Systems - Interface-based factories for device abstraction
  • Service Components - Specialized services for different functions
  • Event System - Internal communication via EventBus

Documentation

For developers:

For users: