External Apps are not directly managed by ManageXR and cannot be installed, updated, or uninstalled by ManageXR. However, External Apps that are manually installed on a device can be approved in a Configuration and included in your Home Screen or set as a Kiosk App.
For example, let's say you want to include Beat Saber in your Home Screen, but you don't have access to the APK file to distribute via ManageXR. In this case, you'd manually install Beat Saber on your device from the hardware provider's App Store, add Beat Saber as an External App in ManageXR, and approve it in your device's configuration. If Beat Saber is installed on your device, it will appear on your Home Screen.
Installing an External App
The first step to using an external app is to manually install it onto your device using native device menus. This is the recommended universal option, as it works with many different hardware types:
Temporarily Disable Kiosk Mode and exit ManageXR
Use native device menus to locate and download content
Re-enable kiosk mode
Using Meta Quest App
Meta Quest users have an additional option through using the Meta Quest App.
Open the Meta Quest App
Click Menu in the bottom right
Open the App Library
Tap the app you wish to install
Click Install on Headset
Adding an External App to ManageXR
Once you've manually installed the app, you can make it appear in your ManageXR Home Screen by adding it to ManageXR as an external app. To do this, you will need the Package Name of the app. A Package Name is an app's unique identifier and can be found in a device's Installed Apps section.
To locate an app's package name:
In ManageXR, head to the Devices tab and select the device you've installed the app store app on.
Click Installed Apps
Locate the app you're adding, and click on the package name below the app title to copy the package name.
Now that you have the Package Name, it's time to create the External App:
Select the VR Content tab ➡️Add Content ➡️External
Add a title for the app and paste the package name
The External App is now added to your VR Content library! Let's add this new store app to a configuration:
Navigate to your Configurations tab and select a configuration.
Click Deploy on your newly added app in the App Library section, and save the changes.
Extra: First Steps App
It's common to add the First Steps app as an external app. In many cases, this app comes preinstalled on Meta Quest 1 & 2 (you can download it from the Meta Quest store for Quest 3), and all you need to do is add it as an external app to have it appear on your home screen.
Oddly, the First Steps app can have two package names that depend on what Meta Quest headset you're using:
com.oculus.MontereySetupQuest 1 & Quest Pro
com.oculus.MiramarSetupRetailQuest 2 & Quest 3
Since First Steps comes on Quest 1 & 2 devices by default, it appears in the device's System Apps. If you don't initially see the First Steps app in your device's Installed Apps section, be sure it is installed on your device and that you've toggled on Show System Apps. For Quest 3 devices, it's recommended to install First Steps from the Tutorials section of the drop-down device menu, in-headset.
Need more help?
Talk to a member of our team using the chat bubble (in the bottom right of your screen), or reach out to email@example.com