Build on Neuraglass

Introduction

System Overview

Connect via ADB over USB or WiFi. Install APKs with adb install just like any Android device.

Standard Android debugging works. adb logcat, Android Studio debugger, and layout inspector all connect normally.

Build Your First App

In Android Studio (or your editor of choice), create a new project with an Empty Activity. Set the minimum SDK to 21.

plugins {
    id 'com.android.application'
}
android {
    compileSdk 33
    defaultConfig {
        applicationId "com.example.helloneuraglass"
        minSdk 21
        targetSdk 33
        versionCode 1
        versionName "1.0"
    }
}
dependencies {
    implementation "androidx.appcompat:appcompat:1.6.1"
}

Override dispatchKeyEvent() to respond to the physical buttons on Neuraglass.

package com.example.helloneuraglass;
import android.os.Bundle;
import android.view.KeyEvent;
import android.widget.TextView;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
    // Neuraglass key codes
    public static final int KEY_OK   = 352;
    public static final int KEY_BACK = 158;
    private TextView statusText;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        statusText = new TextView(this);
        statusText.setText("Hello from Neuraglass!\n\n"
            + "Press CONFIRM to continue.\n"
            + "Press RETURN to go back.");
        statusText.setTextSize(18f);
        statusText.setPadding(48, 48, 48, 48);
        setContentView(statusText);
    }
    @Override
    public boolean dispatchKeyEvent(KeyEvent event) {
        if (event.getAction() == KeyEvent.ACTION_DOWN) {
            switch (event.getKeyCode()) {
                case KEY_OK:
                    Toast.makeText(this,
                        "Confirm pressed!", Toast.LENGTH_SHORT)
                        .show();
                    return true;
                case KEY_BACK:
                    finish();
                    return true;
            }
        }
        return super.dispatchKeyEvent(event);
    }
}

Event Key Listening

Camera APIs

Dependencies

// build.gradle dependencies
dependencies {
    def camerax_version = "1.3.0"
    implementation "androidx.camera:camera-core:$camerax_version"
    implementation "androidx.camera:camera-camera2:$camerax_version"
    implementation "androidx.camera:camera-lifecycle:$camerax_version"
    implementation "androidx.camera:camera-view:$camerax_version"
}

Camera preview with CameraX

class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding
    private var cameraProvider: ProcessCameraProvider? = null
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)
        if (allPermissionsGranted()) {
            startCamera()
        } else {
            ActivityCompat.requestPermissions(
                this, arrayOf(Manifest.permission.CAMERA), 10
            )
        }
    }
    private fun startCamera() {
        val cameraProviderFuture =
            ProcessCameraProvider.getInstance(this)
        cameraProviderFuture.addListener({
            cameraProvider = cameraProviderFuture.get()
            val preview = Preview.Builder().build().also {
                it.setSurfaceProvider(
                    binding.previewView.surfaceProvider
                )
            }
            val cameraSelector =
                CameraSelector.DEFAULT_BACK_CAMERA
            cameraProvider?.unbindAll()
            cameraProvider?.bindToLifecycle(
                this, cameraSelector, preview
            )
        }, ContextCompat.getMainExecutor(this))
    }
    private fun allPermissionsGranted(): Boolean =
        ContextCompat.checkSelfPermission(
            this, Manifest.permission.CAMERA
        ) == PackageManager.PERMISSION_GRANTED
}

Microphone APIs

public class MainActivity extends AppCompatActivity {
    private MediaRecorder recorder = null;
    private MediaPlayer   player   = null;
    private String fileName;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        fileName = getExternalCacheDir().getAbsolutePath()
                   + "/audiorecordtest.3gp";
        ActivityCompat.requestPermissions(this,
            new String[]{
                Manifest.permission.RECORD_AUDIO,
                Manifest.permission.WRITE_EXTERNAL_STORAGE
            }, 200);
    }
    private void startRecording() {
        recorder = new MediaRecorder();
        recorder.setAudioSource(
            MediaRecorder.AudioSource.MIC);
        recorder.setOutputFormat(
            MediaRecorder.OutputFormat.THREE_GPP);
        recorder.setOutputFile(fileName);
        recorder.setAudioEncoder(
            MediaRecorder.AudioEncoder.AMR_NB);
        try { recorder.prepare(); }
        catch (IOException e) { e.printStackTrace(); }
        recorder.start();
    }
    private void stopRecording() {
        if (recorder != null) {
            recorder.stop();
            recorder.release();
            recorder = null;
        }
    }
    private void startPlaying() {
        player = new MediaPlayer();
        try {
            player.setDataSource(fileName);
            player.prepare();
            player.start();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Speaker APIs

public class MainActivity extends AppCompatActivity {
    private AudioManager audioManager;
    private TextToSpeech  textToSpeech;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        audioManager = (AudioManager)
            getSystemService(Context.AUDIO_SERVICE);
        textToSpeech = new TextToSpeech(this, status -> {
            if (status == TextToSpeech.SUCCESS) {
                textToSpeech.setLanguage(Locale.US);
                textToSpeech.setPitch(1.0f);
                textToSpeech.setSpeechRate(1.0f);
            }
        });
    }
    private void startSpeaking(String text) {
        audioManager.setMode(AudioManager.MODE_NORMAL);
        audioManager.setSpeakerphoneOn(true);
        textToSpeech.speak(
            text,
            TextToSpeech.QUEUE_FLUSH,
            null,
            "tts1"
        );
    }
    private void stopSpeaking() {
        if (textToSpeech != null) {
            textToSpeech.stop();
        }
        audioManager.setSpeakerphoneOn(false);
    }
    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (textToSpeech != null) {
            textToSpeech.stop();
            textToSpeech.shutdown();
        }
    }
}

Use AudioManager.setSpeakerphoneOn(true) to route audio to the dual speakers.

Eliza AI Voice

Register custom voice intents that Eliza routes to your app.

Eliza shares what the camera sees. Your app can tap into that context.

Multi-turn dialogue with memory, so users can refine requests naturally.

Dev Tools

Put this in the project root. Claude Code loads it on every session.

Same hardware rules for OpenAI Codex and Cursor Agent. Drop it in the project root.

Quick paste

You are helping me build an Android app for the Neuraglass Dev Kit running Stack OS (AOSP).
This is glasses software, not a phone app. No touchscreen. See-through Micro OLED. Keep UIs small, high-contrast, and short.
Input is five physical keys + voice:
  - Scroll forward (KEY_RIGHT, 106)
  - Scroll backward (KEY_LEFT, 105)
  - Confirm (KEY_OK, 352)
  - Return (KEY_BACK, 158)
  - Power (164)
Hardware: CameraX (16MP), MediaRecorder / AudioRecord, TextToSpeech + AudioManager.setSpeakerphoneOn(true).
Gradle, Java or Kotlin. compileSdk 33, minSdk 21, targetSdk 33. Install with adb install -r.
Always implement dispatchKeyEvent() and consume ACTION_DOWN for those key codes.
Do not invent Helix or Eliza APIs. Those are not public yet.
Do not use TypeScript, REST, Swift, or Python as the glasses runtime.
When asked to build a Neuraglass app, produce a Gradle Android app and show ADB install steps.

The Dev Kit is a normal Android device. Connect via ADB (USB or Wi-Fi) and use the debugger, layout inspector, and profiler. No extra plugin. Install APKs with adb install -r.