Skip to main content

Client SDK & CLI Troubleshooting & Known Issues


This page provides troubleshooting information for using Project Aria Client SDK or CLI. If you cannot find a solution for your problem on this page, go to the Support page for how to contact our team.

Aria Doctor

The Project Aria Doctor utility can help detect and resolve common issues connecting and streaming from the glasses.

Run the utility using the following command and follow the prompts to resolve any issues.


Connection and pairing issues

Computer can't find Aria Glasses

It may be that the battery is drained, make sure your Aria Glasses are correctly charging (there should be a blue LED on the right arm) and wait ten minutes.

On Linux, this may be due to USB driver issues. Run adb kill-server && adb start-server and aria-doctor, then try connecting to Aria glasses again.

Mobile app doesn't receive authorization

If you use aria auth pair and don't receive an authorization prompt in the Mobile Companion app, try the following steps.

  1. Make sure the Mobile Companion app is in the foreground and try again
  2. Restart the Mobile Companion app and try again
  3. Revoke any existing certificates (via Device Settings) and try again
  4. Make sure you're using venv as your virtual environment
    • Users have experienced difficulties using the Client SDK in other virtual environments, such as Conda

If you've paired multiple Aria glasses to the one account

If you've paired multiple Aria glasses to the one account, the wrong glasses may be connected to the app.

  1. Tap Select other on the top right of the dashboard
    • If you see Add glasses instead, only one set of Aria glasses is connected to this account
  2. Tap the glasses connected to your computer

If you're not sure which glasses you're using:

  1. Go to Device Info in the Mobile Companion app to find out the serial number of the glasses that are currently connected to the Mobile Companion app
  2. To find out the serial number of the glasses connected to your computer
    • The serial number is printed on the right arm of the glasses, near the privacy switch (go to the Glasses Manual for screenshots of where it is)
    • In Terminal, use adb devices (ADB is part of Android Studio)
      • The device number returned is the serial number

Streaming or Recording Issues

Lost Internet Connection (MacOS)

If you lose internet connection on MacOS while streaming, run aria-doctor in a separate terminal.

Can't start streaming/recording. RuntimeError: (9) Failed to read data from socket: Operation canceled

You may encounter this error message if you:

  • Tried to start streaming/recording and the Privacy Switch was engaged
  • Turned off the Privacy Switch
  • Immediately tried to start recording again

The Aria glasses were still switching modes. Please try again.

Streaming is laggy/ only some streaming visualizations appear/ visualizer is blank

This issue can occur for several reasons.

Corporate or VPN interference (even if streaming via ADB)

This issue may occur if you're on a VPN or corporate network. Even if you're only streaming via ADB, some security protocols may interfere.

Aria Glasses and Computer on different Wi-Fi networks


This can occur if you know you've set both devices to the same network!

Devices will sometimes preferentially switch back to Wi-Fi connections with stronger signal strength, so you may need to forget a corporate network on the Aria Glasses or computer.

How to adjust Wi-Fi settings via the mobile app
  1. Open the Aria Mobile Companion App
  2. In the Paired Glasses section of the Dashboard, select Select Wi-Fi
  3. Select your preferred network and follow the prompts to connect
    • You can also forget an existing network from the Wi-Fi menu
    • Make sure it is a non-corporate network that is the same as your computer
    • The glasses Wi-Fi network is independent of your phone's Wi-Fi network

Once connected, the Wi-Fi network name will appear in the Desktop App under My Device underneath the WiFi icon which will become blue.

Resources are tied up

You may have a previous streaming session running. Follow the or instructions to stop the stream and free resources.

Linux connection issue

If streaming on Linux does not show any data, try the following steps to address connection issues:

  1. Make sure that you have run aria-doctor
  2. Make sure that the UDP ports used for streaming are not blocked by your machine firewall. You can add an iptable entry to open these ports with the following commands
sudo iptables -A INPUT -p udp -m udp --dport 7000:8000 -j ACCEPT
  1. Ensure that during streaming, USB Ethernet tab in the "Network Settings Window" has Aria selected