Installing and Using MOTAR 3D

Learn how to install and use MOTAR 3D - A companion app to your MOTAR Instance.

MOTAR 3D

Installing MOTAR 3D

Choose your installation method below:

Meta Quest for Business

Guide to adding prebuilt apps to your Meta Quest for Business admin console.

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.

You will need this URL in the upcoming steps!

Add an App

  1. Go to https://work.meta.com/admin/products and login with your admin account.

  2. 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.

  3. In Manage apps, click + Add App in the top right

  4. Pick Externally hosted

  5. Add details

    1. App name: [Name of your app here]

    2. Link to APK File: [past URL link from Studio]

  6. Add visuals (optional)

    1. Add Icon

    2. Add logo

Meta Quest Device - Developer

MOTAR 3D is available for download here:

https://dyn-downloads.s3.us-east-1.amazonaws.com/motar3d_3-2-1_quest.apk

Getting Started

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*.

Meta Quest for Business (MDM)

  1. https://work.meta.com/help/323729803480003/?helpref=hc_fnav Adding apps to the Meta for Business accounts is covered in the above documentation.

  2. Login to the Meta for Work Admin https://work.meta.com/accounts_center/

  3. Add the URL to the MDM Distribution List.

First Time Setup (Developer Mode)

  1. Create a developer account with Meta. You can do this by going to this link and completing their signup process.

  2. Verify your developer account by providing a credit card or mobile number.

  3. If you have not used your headset, complete the initial headset setup/first time user experience before continuing.

  4. 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.)

    1. Download for Android here

    2. Download for iOS here

  5. Login to the headset using the same developer account.

    1. You may have to logout if your current account in the headset is not the same as the developer account setup in step 1.

  6. Login to the phone app with the same developer account.

  7. Connect your headset to the app if not completed during step 3.

  8. From your phone, enable Developer Mode under the Headset Settings.

  1. Open toolbar

  2. 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).

Meta Quest for Business (MDM)

  1. https://work.meta.com/help/323729803480003/?helpref=hc_fnav Adding apps to the Meta for Business accounts is covered in the above documentation.

  2. Login to the Meta for Work Admin https://work.meta.com/accounts_center/

  3. Add the URL to the MDM Distribution List

Meta Quest Developer Hub (MQDH)

  • Follow Meta’s device setup guide here

  • The following steps may repeat portions of the Meta guide

  • Download the Meta Quest Developer Hub(ODH) here.

    1. Next, install it by double clicking on it and running through the installation wizard.

  • Login with your developer account

  • Connect your Meta Quest headset to your computer via the Link Cable or AirLink

  • 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.

MQDH Device Manager
  • 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.

MQDH Devices
MQDH Device added but not connected.
MQDH Device connected.
  • Click the “add build” button to select and install your APK to the headset.

MQDH add a build (APK)
  • Your apk will now install on your Meta Quest 3.

  • To launch the app, see Launching Apps


Vive Focus 3

Manually Install an APK on a Vive Focus Device

MOTAR 3D is available for download here:

https://dyn-downloads.s3.us-east-1.amazonaws.com/motar3d_3-2-1_vive.apk

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

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.

  • Once installed, connect your headset to the computer via Link Cable or AirLink

    • You should see your device in the upper left corner

SideQuest with a Quest connected.
  • Click the “Install APK” button and select your APK

SideQuest Install APK
  • The install status can be seen in the “Running Tasks” tab.

SideQuest check running tasks.
SideQuest current running task list.

Command Line ADB Install (Windows only)

Windows/PC Only

  1. 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."

  2. 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.

  3. Make sure your headset is connected to your PC via a link cable(or compatible USB cable).

  4. 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.

  5. 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.

  6. 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.

  7. 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".

  8. 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:

adb install -r C:\Users\YourName\Downloads\MyCoolNewApp.apk

Using MOTAR 3D

Device Syncing

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.

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.

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.

Launching Apps

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.


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.

Pin Entry

Successfully entering a PIN will allow you to continue in the application without needing to enter a URL/sync from the web.

Welcome Screen after Sync

Saved URLS

URLS entered into the device sync screen are saved locally to make syncing even faster.

Saved URL List

Last updated