How to Use the Data Transfer Tool

How to Use the Data Transfer Tool


The Data Transfer Tool is the central hub for managing headset setup, training content, and data collection.

This tool is available for both PC and Mac operating systems and while you will need access to Wi-Fi before and after the session logs are transferred, Wi-Fi access is NOT a requirement while logs are being collected.
 
This guide will help you open, log in, and operate the tool.
 
Note: The DTT is currently compatible with Meta Quest VR devices, which must have developer mode turned on. Please disable Wi-Fi on headsets when using the DTT.
The workflow begins by ensuring you have the most current App Version and Content Modules downloaded. Once everything is up to date, connect each headset to the computer via USB-C and, from the Provision Headsets tab, load the selected App Version and Content Modules onto the devices.
After provisioning, headsets will be ready for training and should operate offline (with Wi-Fi turned off). When training is complete, reconnect each headset to the computer — still without Wi-Fi — and download the performance logs from the devices.
Once you’ve collected logs from all headsets, connect the laptop to Wi-Fi and use the Upload Performance Logs tab to upload all data in a single batch.
Following this sequence (depicted below) ensures that every headset runs the correct software, training data is stored safely, and all performance logs are securely transferred for review and analysis.

1. Install​ation

  • Download the Data Transfer Tool here
    • Mac users - download the dmg file
    • PC users - download the exe file
Note:
 Future updates will be prompted within the app—no need to revisit the download link. After installation, you might be prompted to provide access to your computer’s Keychain or Credential Vault depending on your OS. Please click “always allow.”


2. Logging In

  • Upon first launching the Data Transfer Tool, you will be required to log in. Once you have logged in, you can use the tool offline until you need to send data to the cloud the next time you go online.
  • Enter the email you use to access the portal and click "Submit" to receive a sign-in link. Check your email for the link and click it. Your app should update and display Logged In within a few seconds.
  • You may login using your portal password by selecting "Log in with a password."

3. Selecting the App Version

  1. While connected to wifi, the Data Transfer Tool will let you know if your VR app is up to date. An option to download the latest version will display if one is available to your organization:

    1. Note: If you belong to more than one organization in the portal, use the drop-down menu at the top right to select from which organization you would like to retrieve the app version.
  2. To manually upload a different VR app version, click on the text that reads, "You can choose to manually select a different version of the app by selecting it here."
  1. You will know you have the latest version downloaded when you see Default Version selected (blue) and the indicator at the top right says App up to date:


4. Choosing Module Content

  1. While connected to wifi, the DTT will retrieve all modules available to your organization.
    1. Note: If you belong to more than one organization in the portal, use the drop-down menu at the top right to select from which organization you would like to retrieve module content.
    2. You may need to download updated versions of the module content:

    3. The screen will look like this if there are no new content updates to download:

5. Choose Module Content

  1. At this point, you can be offline while selecting content to be loaded to headsets, but this also works if you're online.
  2. Manually select the modules you want to push to headsets by clicking on them one at a time:
  3. You can optionally use the dropdown to select all of the modules available to a specific Device Group (as configured in the portal). 
  4. NOTE: The headset you are provisioning does not need to be registered to the same device group via the portal, but this is a best practice to avoid confusion later.

6. Connecting & Provisioning Your Headset(s)

  1. On the Provision Headsets tab, the screen will look like this while your headset is disconnected:


  • Instructions to connect headset:

    1. Ensure that the headset has fully booted up, which traditionally takes about 30 seconds.
    2. Connect your VR headset via USB-C to your computer. If initially unsuccessful, please retry the connection. NOTE: Ensure you are using a USB-C cable that allows transferring data in addition to charging your headset.
    3. Plug one end of the USB-C cable into your headset.
    4. Plug the other end of the USB-C cable into your computer.
    5. In the headset, a prompt will appear to accept the connection —select “Allow” (NOTE: TIME SENSITIVE - the prompt only stays visible for ~5 seconds).
    6. If you miss the prompt, unplug the cable from the computer only (leave it connected to the headset), then plug it back in to trigger the prompt again and select “Allow.”

  • You will know you're fully connected when you no longer see a red "Connect headset" or "Need to accept permissions" message at the top right of this screen:
  1. Press "Sync content with headset" to install the app and modules. Module installation progress will be updated as each individual module installs:
  2. You will see a success message once your headset has been fully synced:

7. Uploading Performance Logs

  • Any logs found on a connected headset will be automatically imported to the Data Transfer Tool as soon as the headset is connected.
  • NOTE: It does NOT matter which screen you are on when connecting a headset -- any available logs will still be pulled off of the headsets.
  • While the computer is online, press "Upload now" to upload any logs that were pulled off of headsets and are pending upload:

  1. You will see a success message when all logs have been uploaded to the cloud:
  2. If you encounter any errors, you can retry uploading the logs:
  3. If you are still having trouble, you can send error logs to the Moth+Flame team for further troubleshooting:


Please reach out to your Moth+Flame Customer Success Manager or support@mothandflamevr.com if you have difficulty syncing your headset fleet with the Data Transfer Tool.



Frequently Asked Questions (FAQ)

Q: Someone else is logged in when I launched the app. How do I change users?
A: Log out by going to the top right and selecting the circular profile icon. Select "Log out." From there, you can log in by following Step 2. When you are finished, you may log out to avoid someone else launching the app with your login credentials.

Q: How does the VR app sent by the DTT behave when an app has previously been installed on a headset running ArborXR or another MDM?
A: The DTT zip file successfully upgrades the app in a pre-existing ArborXR environment, even if the headset is offline. This streamlines the update process, eliminating the need to update the headset with an Arbor package separately.

Q: What is the advantage of using the Data Transfer Tool (DTT) for updates?
A: By using the DTT, you can handle all application and module updates exclusively through this tool without the headset needing to be online. 

Q: What should we expect in terms of app version metadata in the ArborXR home launcher after using DTT for updates?
A: The app version metadata displayed in the ArborXR home launcher will not change. For example, if you click the "more info" button under the Moth+Flame icon, it will still show the old version information. However, when you launch the Moth+Flame App and check the "About" section in the menu, you will see the updated version that was sent via DTT.

Q: What happens if a headset goes online after being updated with the DTT?
A: If the app version in ArborXR is updated to match what was placed on the headset offline, the headset does not require a new download of the app when it goes back online. This ensures a seamless experience even if the headset transitions between offline and online states.

Q: Will headsets that receive updates using the DTT copy over active classes?
A: Yes, active classes associated with the module files will be transferred. 

Q: If I login to DTT with an email that is associated with multiple organizations in the portal, which organization am I logged into? Are the sessions sent to the organization I’m logged into in DTT (if so, how is that determined if my email is in multiple orgs)? 
A: Sessions are not tied to your login. Instead, they are linked to the device group the headset belongs to. This means you can log in and import sessions from another user's headset, and the sessions will still report accurately to the device group and organization that the headset is assigned to in the portal.

Q; I'm having issues with the DTT and can't upload my sessions or logs to the portal. Is there another way I can upload them?
A: Yes. Contact support@mothandflamevr.com for instructions.

Q: Does the Data Transfer Tool support OBB files?
A: Yes, to upload an OBB file, make sure to create a zip file and include the OBB file as well as the apk file. The name of the zip file should follow the format "vrconversation_" followed by the version number, for example, 0.15.5.860.

Q: If headsets are in the wrong Device Group in the portal and I move them to the correct device group before syncing sessions from the DTT to the cloud, which device group will the sessions go to when running a report?
A: The sessions will be assigned to the device group they are in at the time of the cloud sync. So, in this example, sessions will go to the correct device group.







    • Related Articles

    • Manually transfer files from a Data Transfer Tool .zip file (if Data Transfer Tool is causing errors while uploading .zip)

      If a fleet of devices requires an update and the headsets do not have access to wifi, and the Data Transfer Tool is not available or there was an error, there are two ways to deploy module updates: 1. Use an MDM (ArborXR) configuration package 2. Use ...

    • Moth+Flame App Release Announcements

      Release announcements for the latest app version will appear here. If you have any questions, please don't hesitate to contact us at support@mothandflamevr.com If you would like to suggest a product improvement, please submit your idea here. Release ...

    • Clone a VR Headset to Update a Device Fleet without Wifi

      If a fleet of devices requires an update and the headsets do not have access to wifi, there are two ways to deploy module updates: 1. Use an MDM (ArborXR) configuration package 2. Use SideQuest to clone a VR headset - Prerequisites for using this ...

    • Moth+Flame Create Release Announcements

      Release Update 9/23/2025 Version 3.31 Updates and Enhancements Character Update: Removed unavailable Colossyan characters from the character list to ensure only supported avatars are available for selection. Improved system stability: Fixed ...

    • Moth+Flame Browser Player

      Moth+Flame's Browser Player extends the immersive and interactive experiences of our VR platform directly to your web browser. Without the need for specialized hardware, learners can access the same rich, engaging content from virtually anywhere. ...