All Collections
Product Changelogs
Device Setup App Changelog
Device Setup App Changelog

A log of the most recent new features, changes, improvements and bug fixes for ArborXR's Device Setup app.

Josh Franzen avatar
Written by Josh Franzen
Updated over a week ago

Build 2024.8.0



  • Accounts were not being automatically removed on Meta Quest devices running OS v62, leading to an error.

Build 2023.49.0



  • After selecting a configuration package, users now see a loading indicator.

  • Send any configured endpoints to the client app during setup.

  • Connected devices now send device firmware version to determine which content channel builds are needed.


  • Device firmware version is now used when pairing with the backend so devices get valid content.


  • Device title would not perist between reinstalls.

  • When switching organizations, users were not prompted to confirm their password.

Build 2023.45.1



  • Support for multi-organization SSO login.


  • Increased the window size of the app for a better experience.

Build 2023.28.0



  • SSO login support.

Build 2023.25.0



  • Windows ARM64 support.


  • Quest 2 devices would fail setting device ownership when re-enrolling the device.

Build 2023.23.1



  • Some devices would display an "Application not responding" message in the headset following a successful enrollment.

Build 2023.21.1


  • Added

  • Show the app version in the title.

  • Show the device group name of a selected configuration package.


  • When a new app version is found while running, we prompt the user to update.


  • On setup, devices with multiple users did not show error when setting device ownership.

Build 2023.21.0



  • Device architecture armeabi-v7a was not found.

Build 2023.19.0



  • Grant REQUEST_INSTALL_PACKAGES permission during setup for Android 11+ devices.

Build 2023.17.0



  • The reboot step for Vive Flow OS version 2.03.623.01+ has been removed as it interrupts the client app configuration during configuration package enrollment.

  • Devices with armeabi-v7a architecture were not supported.

Build 2023.16.0



  • Support for videos in configuration package enrollment.


  • Update to USB Debugging KBA link.


  • Configuration package enrollment did not support files missing file extensions.

Build 2023.8.0



  • The "Setting Refresh Token" step would sometimes fail during a simple or group enrollment.

Build 2023.7.0



  • Reconnecting a device sometimes threw a query error after enrolling.

  • Mac machines would not close the current Setup App window when updating the application.

  • Updating the Setup App would sometimes fail when replacing the adb.exe file.

Build 2023.5.1



  • Setup would fail if starting the Client App resulted in a warning message.

Build 2023.5.0



  • Organizations are now searchable in the Setup UI.


  • Improved pairing app Sentry logging.

  • No longer throw an error when a device is disconnected while running an ADB command.


  • Configuration package enrollment would fail if the "Configuring Device" step tried to configure the device to a group with over a GB of content.

  • No longer show the "Manage Device" button for users with the role Device Setup App User, since they don't have access to manage devices.

Build 2023.4.0



  • For users with the role Device Setup App, the "Select Device Group" option in the device setup app is now hidden and clicking Set Up automatically enrolls devices into the organization.

  • Disabled the Set Up button when devices are disconnected.


  • Not all Mac devices could see the Setup dialog to select a group or simple enrollment.

Build 2023.3.3



  • The list of organizations would only display the first 20.

Build 2023.3.0



  • Provision devices while unauthenticated using configuration packages generated via the web portal.

  • Enroll devices directly to a group.

  • Intercom widget for support.

Build 2022.49.0



  • Timing issues would sometimes cause the device setup process to fail.

Build 2022.47.0


  • Devices requiring the ARMv7-A Application Binary Interface (ABI) are now supported.

Build 2022.46.0



  • Attempts to enroll Pico 4 Enterprise devices would fail due to a broadcast error.

  • Not all Meta accounts would be removed, due to a regression.

Build 2022.43.0



  • Reduced number of unhelpful errors being reported.

Build 2022.35.1



  • On Meta Quest devices, the setup process has been updated to now automatically remove all Meta accounts if needed.

Build 2022.32.0



  • Meta Quest devices could not complete the setup process when Guardian was enabled and displayed a 'Tracking and Guardian Not Found' dialog. The setup failed with an error code -96 instead.

Build 2022.31.0



  • Links to support articles have been updated to point to the new knowledgebase.

Build 2022.29.0



  • Previously, several adb commands were required to be run as part of the initial device setup process of the VIVE Flow. With this improvement, ArborXR's Device Setup App automates the running of these adb commands, thereby enabling a one click setup flow.

Build 2022.28.0



  • Devices requiring the x86_64 Application Binary Interface (ABI) are now supported.


  • New device models are automatically supported as long as the client app supports their architecture. Previously users had to reach out to support and request the manual addition of a new device model.


  • Users were frequently required to log back in during longer sessions.

  • Depending on where the setup app was installed, setting up devices failed with a "Read-only file system" error.

Build 2022.24.0



  • On Meta Quest devices, the setup process will now automatically remove all accounts if needed.

Build 2022.23.0



  • Updating the app failed when the previous app version started the ADB process to communicate with devices. The user was greeted by a file-in-use error.

  • Meta Quest devices could not complete the setup process when the device was asleep. The setup failed with an error code -96 instead.

Build 2022.20.1



  • Opening the settings app to remove accounts failed on Meta Quest devices running version 40 or later of the operating system.

  • When reinstalling a device, the name was shown as the serial number even though a custom device name was provided.

  • Logging out of the app didn't work and instead resulted in an error message being displayed.

Build 2022.11.0



  • Attempting to set up a device that is unknown to the platform now gives a specific error. Previously the app showed install progress that never advanced or finished.

  • The "Set Up" button can now be used to reinstall the apps to devices that are already set up. Previously a small "Reinstall" button had to be used instead.

  • A device is only shown to be set up if it has the apps installed, is paired to the platform and is not marked for deletion on the platform. Previously the device was shown to be set up and the "Reinstall" button was visible solely based on whether the device had the apps installed.

  • Connected devices are no longer selected automatically in case they are already set up with another organization. The selection of these devices is disabled until the user switches the active organization to the one the device is currently paired to.

Build 2022.8.1



  • The app now supports the latest client, as well as the new launcher, ArborXR Home.

  • A new modal shows when the cached client and launcher apps are updating, ensuring devices are set up with the latest apps once the setup process is started.


  • To give a familiar experience, the UI has been updated to follow various design changes applied to the web portal.

  • As part of the added support to install ArborXR Home, the app has been renamed to Device Setup App.

Build 2021.41.0



  • To ensure the client app has received all data required to finalize the pairing process, the device pairing app now asks the client app to confirm that. This additional check is done at the end of the pairing process and ensures the device is successfully paired.

  • On Oculus Quest devices the app starts the settings application if the device owner cannot be set due to Android user accounts preventing it. The user can then remove the accounts from within the headset, without having to open the settings application manually.


  • In some cases, specific devices might not be able to automatically start the client app due to a restriction Android applies to applications that have never been visible to the user. To overcome the issue, the client app is now started at the end of the pairing process and is visible in the headset for a short period of time before it closes itself.

Build 2021.32.0



  • In case an error occurs during the pairing of a device, the device pairing app now attempts to uninstall the client app.

Build 2021.26.0



  • Some devices had a chance to raise errors when installing the client app while another ADB operation was running at the same time.

Build 2021.23.2



  • On macOS, once the user was logged in and later closed the app, all further attempts to start the app had a chance to never progress past the loading indicator.

Build 2021.23.0



  • Logging out failed in specific scenarios and resulted in a loading icon to be displayed until the user restarted the app.

Build 2021.22.0



  • Additional details have been added to the logging to ease troubleshooting of potential issues.

Build 2021.21.0



  • The model name for connected devices is now the same name that the web portal shows.


  • On Windows, the machine could take a while to start up the updater once the user started it. Anti-virus software is blocking the start of the updater until it finishes scanning the file for viruses. The result is a longer wait, in which a user may attempt to start the app again before the self-update completed. As this sometimes crashed the app, the self-update process has been changed to not close the app until the update is started. Once it is running, the updater will ask the user to close the app instead.

  • If the updater was started at the end of the app's shutdown process, the updater was unable to identify that the app is still running. This had a chance to fail the update process.

Build 2021.17.1



  • File management wasn't working and gave permission errors on devices running Android 10.

  • On devices running Android 10 or later, the app stopped reacting to changes done in the web portal if file management failed.

Build 2021.18.0



  • The app now updates itself in the background and notifies the user that they can restart the app with a button click to run the latest version. In case the user does not apply the update in the running session, the update is installed the next time the app starts up.

  • Preview builds of the app can be used side-by-side with the regular version of the app.


  • On Windows the app is now distributed via an installer/setup executable. Users can delete previous versions of the app once they have installed the new version.

  • There can only be a single running instance of the app. The existing window is brought to the front when the user attempts to start another instance.

  • The internals of the app have been adjusted to prevent silent warnings while the user is not yet logged in.


  • On macOS the app sometimes crashed on startup while the user was logged out and an update to the app was available.

  • The operating system version used for troubleshooting purposes on macOS was giving details about the Unix kernel instead of the macOS version.

  • The user was not asked to log in again when the login session was no longer valid.

Build 2021.14.0



  • Automatic error collection stopped after a specific error was encountered.

  • Links to some knowledge base articles were outdated.

Build 2021.12.0



  • All apps now include detailed version information to ease the process of identifying development and QA builds. The user-facing versions are staying the same.


  • Requests to the servers are retried only when encountering transient issues. Additionally a timeout has been added to help with connection issues. Previously all errors were retried, even if there was no chance for the next attempt to give a different result. This resulted in some operations taking longer than expected.

Build 2021.10.0



  • The app now identifies itself as such in login sessions. This allows the web portal to display that the user is logged-in in the app, in contrast to being logged-in in the portal itself.

Build 2021.9.0



  • To be more responsive when encountering connection problems, all communication with the servers is retried a few times. Previously the affected operations would only be retried ten seconds later (or even later, depending on the operation).

  • Additional logging has been added to ease the process of diagnosing communication problems with the servers.


  • Installing the client app to specific devices failed because the device's temporary directory didn't exist yet.

  • Reinstalling the client app on a device didn't correctly wipe the past app's data. This in turn prevented the new install from showing up on the web portal.

  • When a device's client app was deactivated remotely via the web portal, it took up to 5 minutes for a new installation to that device to show up in the web portal.

Build 2021.8.0



  • Various issues that can occur during the pairing process are directly recognized. Along with an explanation of the encountered issue comes an instruction on how to potentially resolve the issue. For selected issues a link to an article of the knowledge base is given, too.

  • A connected device's title can be changed as part of a reinstall operation.

  • The app checks for updates to itself and asks the user to update (manually).

  • On macOS the app links to the support page from the help menu item.


  • The versioning scheme used by both the client app and the app is more user-friendly. Both apps follow the scheme `Year-WeekOfYear-[FurtherRelease]` where `FurtherRelease` is an ever increasing number that is starting at `0` and is attached as a suffix to the original release of the same week. E.g.: A release in the first week of 2021 is `2021.1.0`. A release to fix an issue that is released in the same week will bump that version to `2021.1.1`, while any further release in the same week would result in `2021.1.2` and so on. The (first) release of the second week will use `2021.2.0`.

  • The app and the client app now use the system's built-in networking technology, which ensures proper support for TLS 1.2 and other modern network communication standards.

  • Logging has been improved to allow easier troubleshooting of issues. Additionally, if a crash occurs the details are collected the next time the application runs.

  • The app asks to log in first, before showing the devices table. I.e. a short visible flicker of the table has been removed.

  • The technology used for the app has changed. It supports older operating system versions on both Windows and macOS: Windows 10 version 1803 (April 2018 Update) or macOS version 10.11 (El Capitan) or later are required

  • The size of the app has been greatly reduced on both Windows and macOS.

  • On Windows the app supports the [WebView2 Runtime]( On PCs that do not have the WebView2 runtime installed yet, the older built-in WebView is used.

  • The signed-in session displayed in the user's Account Settings page is able to list that a session is from the app.

  • On macOS the crash details shown by the operating system have been significantly improved to help with troubleshooting.

  • The app is sandboxed on macOS, bringing additional security to Mac users.

  • Reinstalling the client app via the app works without having to uninstall the previous version. This change works around an issue on devices that have a bug in the Android internals, which required a factory-reset any time the client app should be reinstalled on affected devices.


  • To ensure the device can't get into a state that can't be resolved, the app no longer allows canceling the (re)install to a device.


  • Logging out of the app didn't always start the login flow again.

  • The sign-in session of a previous run of the app was sometimes not utilized, despite it still being active. The user is no longer asked to log in again in this case.

  • The app didn't recognize that the sign-in session was no longer valid and consequently didn't ask the user to log in again. Until the app was restarted, this resulted in (re)install operations failing at the very end and connected devices that were already paired to the platform failed to show the device's title.

  • A connected device that is still booting up had a very small chance to cause the app to not update the devices list for a few seconds.

  • On macOS the app didn't behave like a regular app. That included proper window shadows, the expected menu items like text cut, copy and paste as well as support for various shortcuts (including closing the window and quitting the app).

  • The app had a small chance to crash on startup on specific Mac models.

  • On VR devices that use a more modern Android version the app sometimes had issues pairing the installed client to the platform.


Did this answer your question?