Skip to main content

How to Capture Logs for the Aria Desktop App

Overview​

This page provides information about how to gather logs from the Aria Desktop Companion app. Logs are not necessary prior to filing a bug report or seeking technical support, but they can be helpful. People are most likely to use this page if they have been asked for log files by Project Aria User Support (AriaOps@meta.com).

You turn on logging when you run the app, you cannot gather logs retrospectively. You will need to use these commands every time you want to run the Desktop app with logging enabled.

note

Linux support for the Desktop app is limited (see requirements) and only v36 is available. Please use the MPS CLI to request Hand Tracking MPS.

Enabling logs​

On MacOS or Windows, enable logging by closing the Desktop app and then relaunching it via the command line with logging turned on. Logs will be added to aria_output.log, which will be created in your user home directory.

If you don't fully quit the app, there is a risk your system may open an existing instance with logging turned off, instead of opening a new instance with logging enabled

MacOS​

  1. Quit the Desktop app, if it is running
  2. Open your terminal and run:
open /Applications/Aria.app --args --log-output
  1. The Aria Desktop app should then open with logging enabled
  2. The logs will be stored in ~/.aria/logs/aria_desktop_app_{date}_{time}.log
  3. Logs will continue to be added to this file until you quit the app
  4. If you generate logs at a later time, they will be appended to the end of these logs

Windows​

  1. Quit the Desktop app completely
    • Close the app by right-clicking the Aria logo (it looks like glasses) in the right end side of the taskbar, and selecting "Quit" or
    • Open Task Manager and end the "AriaHub.exe" running task.
  2. Use the run command (Windows + R) or Windows terminal to run:
"C:\Program Files\Aria\v3\AriaHub.exe" --log-output
  1. The Aria Desktop app should then open with logging enabled.
  2. The logs will be stored in The logs will be stored in ~/.aria/logs/aria_desktop_app_{date}_{time}.log
  3. Logs will continue to be added to this file until you quit the app
  4. If you generate logs at a later time, they will be appended to the end of these logs