Guide to adding prebuilt apps to your Meta Quest for Business admin console.
WARNING : Before launching an app on a Meta Quest device, ensure your Meta Quest device is operating on at least v76.
Due to a bug in Meta Quest OS v74 apps may not launch properly.
Prerequisites
This guide is for Meta Quest for Business admins and will walk you through the process of adding an app from MOTAR Hub to the admin dashboard.
Your account must have an admin role assigned with relevant permissions before you can create an app in Meta Admin Center. If you are unsure of your access permissions, contact your Meta admin or visit Meta’s Manage admin roles and product access page to learn more.
Get the App Listing URL
Login to Studio and go to the app listing > Distributions section
Toggle the dropdown arrow (indicated on the above image)
Locate the download URL and click the copy button.
To add an app from an APK file to your organization’s apps in Admin Center, click Apps icon in the left menu of Admin Center.
In Manage apps, click + Add App in the top right
Pick Externally hosted
Add details
App name: [Name of your app here]
Link to APK File: [past URL link from Studio]
Add visuals (optional)
Add Icon
Add logo
Meta Quest Device - Developer
WARNING : Before launching an app on a Meta Quest device, ensure your Meta Quest device is operating on at least v76.
Due to a bug in Meta Quest OS v74 apps may not launch properly.
The Meta Quest 3 (and Meta Quest 2, Pro, 3s) use files called APKs to install apps. When interacting with an APK downloaded from MOTAR Hub, users can side-load the application to the Meta Quest device.
Installing “ad hoc” applications to a Meta Quest device requires either a Meta Quest for Business MDM account, a developer account, 3rd party software, or a 3rd party MDM*.
3rd party MDM’s differ in functionality and are not covered in this guide. Please contact your MDM provider for details on how to install apps.
First Time Setup (Developer Mode)
Create a developer account with Meta. You can do this by going to thislinkand completing their signup process.
Verify your developer account by providing a credit card or mobile number.
If you have not used your headset, complete the initial headset setup/first time user experience before continuing.
Install the Meta Horizon app on your phone and log in with your newly created Meta account. (This step is an optional part of the first time user setup in the headset and may have been completed previously.)
Login to the headset using the same developer account.
You may have to logout if your current account in the headset is not the same as the developer account setup in step 1.
Login to the phone app with the same developer account.
Connect your headset to the app if not completed during step 3.
From your phone, enable Developer Mode under the Headset Settings.
Open toolbar
You can find this option by going to Menu > Devices > Pick the device you wish to use > Headset Settings > Developer Mode. Toggle Developer Mode to ON
How to Install an App
There are three ways* to side-load an app onto the Meta Quest headset, using the Meta Quest Developer Hub (via Wi-Fi or link cable), the SideQuest application, or the Command Line (via a link cable).
After setting your device to Developer Mode, you can open up the Developer Hub app to view your "connected" device under the Device Manager tab.
You should see your device connected under the Devices tab. If you do not see your device and it is connected via a USB-C cable, click "Set Up New Device" and follow the on screen instructions.
Click the “add build” button to select and install your APK to the headset.
Installing apps on your Focus 3 requires a USB-C cable. Plug the cable into your computer and then into the device. You may need to 'authorize' the computer in the headset.
On Your Computer
Once your computer is connected to your Focus 3, you should see the device folder in your computer file explorer.
Drag the downloaded MOTAR 3D to the Focus 3 "Downloads" folder.
On Your Focus 3
Put on your Focus 3 and navigate to "Storage/Downloads" Click on the MOTAR 3D file and choose "Install"
SideQuest is a 3rd party tool which allows installing software outside of the Meta Quest Store (ad hoc). SideQuest is community run and the developers work closely with Meta to allow developers a platform for showcasing their early work. Recently, Meta has allowed some integration with SideQuest via the Meta Quest Labs.
Download the SideQuest application here. Next, install it by double clicking on it and running through the installation wizard.
Install ADB Drivers from here. ADB is the software that lets PCs transfer and installs apps onto Android-based devices like Oculus standalone headsets. When the download finishes, unzip the downloaded file folder. Now right-click on android_winusb.inf and click Install. When prompted click open followed by yes to get a message that says, "The operation completed successfully."
Next, you need to download the SDK platform tools from here. Extract the contents of the platform-tools folder to an easy-to-find folder on your PC, such as C:\ADB\users\"YourName" by selecting all the contents of the folder and copying(CTRL+C) and pasting(CTRL+V) it into the new location.
Make sure your headset is connected to your PC via a link cable(or compatible USB cable).
Open the Command Prompt. Right-click on the Windows Start button at the bottom left of your screen and click Command Prompt (Administrator) or click on the windows icon and type "cmd" and press enter.
In the command prompt type "adb" and a string of text should pop up if you completed everything correctly, but this message will pop up if the ADB drivers and platform tools weren't installed properly: 'adb' is not recognized as an internal or external command, operable program or batch file.
Type "ADB devices" to view "List of devices attached" with the device listed below(represented by a list of numbers and letters). It will most likely say "unauthorized" next to that so you will need to put on your headset and select "Always allow from this computer" or "allow" to allow your Oculus to connect to your PC. After this, in the command prompt, it should say "device" instead of unauthorized.
Install the app via command line by manually entering in the file path and app name or copying the path. To copy the path, hold shift, right-click on the APK file, and select "copy as path".
In the command prompt, type adb install -r command followed by the full path to the sideloaded app you want to install then press enter. It should say "success" in the command prompt if everything worked correctly. Example:
When MOTAR 3D launches for the first time, you will be presented with the Sync Device screen. This allows users to sync their headset to their user profile in MOTAR.
Simply input the domain for your MOTAR instance and click ENTER.
No need to enter "http". Just enter your domain and subdomain (if applicable), such as "motarghost.com" or "demo.motarghost.com"
If your URL is entered correctly, MOTAR 3D will generate a Sync Code. This code is then entered into the devices page on your MOTAR Instance.
Go to devices.<your-motar-instance> on a web browser.
You may be prompted to login. Once you are logged in, the devices page
Enter the generated code from the app.
Click "Sync Device" and then return to your headset.
Your headset will authenticate and logged you into MOTAR 3D and you will see your profile picture and name.
Click "Continue" to proceed to MOTAR 3D.
After Syncing your headset, you will be brought to the Hub on MOTAR 3D
From here, you can view MOTAR 3D compatible assets (which you have permissions for) and launch installed applications.
Application installation may vary depending on your organization. Check with your administrator for details.
Launching Apps
WARNING : Before launching an app on a Meta Quest device, ensure you have your Guardian activated and set to RoomScale.
Due to Meta update v74, inactive Guardians and Stationary guardians may prevent apps from launching properly.
If an app is installed on your device and you have permissions to launch the app, you can launch directly from MOTAR 3D.
Select the app from the Hub menu by clicking on the listing card.
Click "Launch" from the menu on the right.
If an app is launchable, the "Launch" button will be enabled. Otherwise, you will not be able to launch the app.
Multiplayer Session
Currently, MOTAR 3D allows multi-user collaboration. If your MOTAR License has the multiplayer feature enabled, simply login to MOTAR 3D. Anyone in your organization (using the same URL to sync their device) will be able to join you in the Holodeck!
Not sure what license features you have? Check with your Platform Admin or Contact Us!
Additional Features
Using your PIN
When entering a sync code on the Devices page, you are given the option to create a pin code.
Syncing your device stays "active" for 24 hours. This allows you to continue using your device without the need to sync. Simply enter your PIN and continue.
Successfully entering a PIN will allow you to continue in the application without needing to enter a URL/sync from the web.
Saved URLS
URLS entered into the device sync screen are saved locally to make syncing even faster.
