Setting Up RealWear Collaborate for Organizational and External Contacts with Custom Configuration

This guide explains how to configure RealWear Collaborate using a custom config.json file that controls how contact information is sourced within the application.

By applying these setting, Collaborate is enabled to display both organizational contacts and external contacts, expanding the available directory for user communication.

1. Creating the config.json File

Follow the steps below to create the configuration file used by RealWear Collaborate.

Steps

1. Open Notepad (or any plain-text editor).

2. Copy and paste the following configuration content:

   {
"contactsSource": "orgAndExternals"
}

3. Save the file with the name:

   config.json

4. Ensure the file extension is .json (not .txt).

   • You can confirm by selecting Save as type: All Files before saving.

2. Applying the Configuration to a RealWear Device

Before applying the configuration, confirm that you have:

• A RealWear device

• A compatible data cable:

  • USB-C cable for Navigator devices.

  • Micro-USB cable may be required for some older HMT-1 devices that use Micro-USB for data transfer

• A computer with ADB installed

• The config.json file available on your computer

2.1 Prerequisites

1. Connect the device to your computer using the appropriate cable.

2. Confirm that ADB detects your device by running:

   adb devices

2.2 Apply the Configuration File

There are two ways to place the config.json file onto the device.

Option A: Push the File Using ADB (Recommended)

Run the following command in a Terminal or Command Prompt window:

• First parameter: Path to the file on your computer

• Second parameter: Target directory inside the RealWear device

• Expect confirmation such as:
  1 file pushed

Option B: Manually Copy and Paste the File

You may also transfer the file manually if the device is recognized as a media/storage device by your computer.

1. Connect your RealWear device via USB.

2. Open the device storage on your computer.

3. Navigate to:

   /Android/data/com.realwear.acs/files/

4. Copy and paste the config.json file into this folder.

5. Safely disconnect the device.

3. Restart the Collaborate Application

To activate the new configuration:

• Option 1: Open Recent Apps, close Collaborate, and relaunch it.

• Option 2: Restart the device, then open the Collaborate app.

Useful links:

Collaborate Technical Info - Enabling Collaborate in your organization