Skip to main content

Get Started

Aria Studio is a desktop application for managing Project Aria glasses and recordings. It is part of the Aria Research Kit (ARK) and replaces the legacy Desktop App (deprecated May 30, 2025). Aria Studio provides a single interface to connect to Aria devices, browse and import VRS recordings, run Machine Perception Services (MPS), and visualize the results.

Key features​

  • Device management — Connect to Gen 1 and Gen 2 Aria glasses over USB, browse on-device recordings, and import them to your computer.
  • Local recording library — Organize VRS files on disk, view metadata and thumbnails, and group recordings for multi-SLAM processing.
  • MPS integration — Request SLAM (Simultaneous Localization and Mapping), eye gaze, and hand tracking results for individual recordings or recording groups directly from the UI.
  • Rerun visualization — Stream VRS sensor data and MPS outputs into the Rerun viewer for interactive 3D exploration (all streams except audio).
  • Live streaming (Gen 2 only) — Stream live sensor data from your glasses.
  • Custom recording (Gen 2 only) — Start and stop recordings with custom profile settings.

Supported Platforms​

OS / PlatformOS / Distro DetailsAria Gen2 SupportSupported Python Versions
Linux (x64)Ubuntu 22.04 LTS (jammy) / 24.04 LTS (Noble Numbat), and recent Fedora releases. Requires glibc 2.34 or newer✅ Supported3.11+
Linux (ARM64 / aarch64)—❌ Not supported — VRS Health Check has no ARM64 wheel—
macOS (Apple Silicon / ARM64)macOS 14+ (Sonoma or newer) on M1/M2/M3/M4✅ Supported3.11+
macOS (Intel / x64)—❌ Not supported — no x86_64 macOS wheels exist for the packages Aria Studio depends on—
Windows (x64)—🚧 Planned — previous one-click installer available for v1.0.3 and earlier; native support pending Client SDK for Windows—
Where these limits come from

Aria Studio is pure Python, so its platform matrix is inherited from what it installs: projectaria-client-sdk sets the glibc 2.34 floor (Ubuntu 22.04 and newer), projectaria-tools sets macOS 14+, and projectaria-vrs-health-check — which has no ARM64 wheel — is what rules out ARM64 Linux. Python 3.11+ is Aria Studio's own requirement, stricter than the 3.10 the rest of the toolchain accepts.

Installation​

Requirements​

  • Python 3.11 or later
  • A virtual environment is recommended

Install​

python3 -m pip install aria_studio --no-cache-dir

Using a virtual environment​

python3 -m venv ~/projectaria_gen2_python_env
source ~/projectaria_gen2_python_env/bin/activate
pip install aria_studio --no-cache-dir

Launch the application​

Run the following command:

aria_studio

The application opens a browser window at http://127.0.0.1:8000. To choose a different port or suppress the browser:

aria_studio --port 9000 --no-browser

If you used a virtual environment, reactivate it before launching:

source ~/projectaria_gen2_python_env/bin/activate  # Linux/macOS
aria_studio
tip

Closing the browser tab does not quit Aria Studio — the server continues running in the background. To fully stop the application, press Ctrl+C in the terminal.

Log in​

User Type Selection screen showing Gen 1 and Gen 2 buttons

When you first launch Aria Studio, you'll see the User Type Selection screen. Choose the glasses generation you're using and follow the login prompts. For detailed instructions, credential storage, and session management, see Authentication.

Home screen​

After logging in, you'll see the Home dashboard with quick access to the main features:

Home dashboard

Below the feature cards, the Home screen also shows the latest Project Aria updates (see Read Project Aria news) and a Helpful Links row with shortcuts to the Aria Research Kit documentation, the Machine Perception Services overview, the Aria Discord, and the full Project Aria Updates page.

Read Project Aria news​

Aria Studio surfaces announcements from Project Aria — new releases, OS and Mobile App updates, and feature highlights — directly in the app. The feed is fetched live, so it stays current without reinstalling Aria Studio.

The Project Aria updates section on the Home screen shows the most recent announcement. To see the complete history, click See all (or the Project Aria Updates card under Helpful Links).

Project Aria updates page listing all announcements

The collapsible sidebar is visible on every page after you log in. It provides access to:

TabDescription
Recordings on glassesManage recordings stored on your connected glasses
Recordings on computerManage imported VRS files on your local machine
GroupsOrganize recordings into groups for Multi-SLAM
Past MPS requestsView status of all MPS processing requests
SettingsConfigure upload, download, and processing options
LogsView application logs for troubleshooting
FeedbackSubmit bug reports or feature requests

At the bottom of the sidebar you'll find:

  • Glasses — Shows the connected device's serial number, battery level, Wi-Fi status, and available storage. For Gen 2 devices, this panel also has Custom Recording and Streaming buttons.
  • User Info — Displays your username and a Logout button.

MPS configuration​

Aria Studio shares its MPS configuration with the MPS CLI. Settings are stored at $HOME/.projectaria/mps.ini and control upload/download speeds, retry behavior, and concurrency. You can modify these settings through the Settings page in the app.

Licensing​

Aria Studio is Meta Licensed Materials distributed under the Apache License, Version 2.0.

Next steps​