D-BOX Remote Software Management

HSC and System Configurator - Silent Installation

HSC - Disabling the Auto-Update Check

HSC - Unattended Login

Silent Installation

Silent installation allows D-BOX software to be deployed remotely or as part of an automated setup process, without requiring any user interaction. This is useful for IT administrators managing multiple machines, commercial venues, or any environment where hands-on installation is impractical.

HaptiSync Center

Pass the following arguments to the HaptiSync Center installer to run it silently:

/silent /AcceptLicense:yes

System Configurator

Pass the following arguments to the System Configurator installer to run it silently:

/silent /AcceptLicense:yes

To update firmware on a device using the System Configurator CLI:

SystemConfigApp.exe -UpdateFirmware

Disabling the Automatic Update Check

By default, HaptiSync Center periodically checks for updates and displays a notification pop-up. In automated or unattended environments, this pop-up can be disruptive. There are two ways to disable it.

Option 1 — Via the UI

Right-click the D-BOX icon in the system tray (bottom-right corner of the taskbar), then uncheck “Automatic Update Check”.

Option 2 — Via the Windows Registry

Set the following registry value to disable the automatic update check, then restart the HaptiSync Agent service for the change to take effect:

Computer\HKEY_CURRENT_USER\Software\D-BOX\HaptiSyncBgApp

Value name: EnableAutoUpdates

Value type: REG_DWORD

Value data: 0x00000000 (0)

Important: This setting is per-user. It is stored under HKEY_CURRENT_USER, which means the setting only applies to the Windows user account under which the change was made. If the PC is later used under a different user account, the Automatic Update Check will be enabled again by default. To apply this setting system-wide, the registry change must be made for each Windows user account that will run HaptiSync Center.

HaptiSync Center — Unattended Login

Unattended Login lets you link a D‑BOX Connect account to D-BOX HaptiSync Center (via D-BOX Motion Engine) without using a browser or UI prompts. Instead of clicking through HaptiSync Center, you run a CLI command with your credentials. This is especially useful for Commercial Venues or Training Venues using automated PC setups where no user is physically present.

Prerequisites

Before you start:

• D-BOX HaptiSync Center is installed on the PC.
• You have a valid D‑BOX Connect account:
  • Username (your email address)
  • Password
• You have access to a command prompt or terminal on the machine.

Basic Usage

Unattended login is performed using HaptiSync Center’s CLI authorize command.

Syntax:

HaptiSyncCenter.App.exe authorize -u <username> -p <password>

Replace:

• <username> with your D‑BOX Connect username
• <password> with your D‑BOX Connect password

Example:

HaptiSyncCenter.App.exe authorize -u jane.doe@example.com -p MyPassword123

Note: The exact executable path may differ depending on your installation and OS. Adjust as needed (e.g., run from the install folder or use the full path).

Capture exit code

When running the authorize command from a script or automation tool, the result (exit code) may not be captured correctly by default. This is because HaptiSyncCenter.App.exe is a GUI-subsystem executable, and both Command Prompt and PowerShell will return control immediately—before the process finishes—unless you explicitly wait for it.

To properly capture the exit code, use the appropriate wait command for your shell:

 Command Prompt (cmd.exe)

start /wait "" HaptiSyncCenter.App.exe authorize -u jane.doe@example.com -p MySecurePassword123

echo Exit code: %ERRORLEVEL%

 PowerShell

$process = Start-Process -FilePath "HaptiSyncCenter.App.exe" -ArgumentList "authorize -u jane.doe@example.com -p MySecurePassword123" -Wait -PassThru

Write-Output "Exit code: $($process.ExitCode)"

What Happens When You Run the “authorize” Command

• HaptiSync Center starts in CLI mode.
  • It does not interfere with any already-running HaptiSync Center UI instance.
  • It runs just long enough to complete the authorization.
• Your credentials are sent securely to D-BOX Motion Engine.
  • D-BOX Motion Engine uses them to request an authorization token from our authentication service.
• D-BOX Motion Engine authorizes your PC.
  • On success, your PC is now linked to your D‑BOX Connect account.
  • Future sessions can use this authorization without additional UI interaction.
• The command exits with a status code.
  • This tells scripts and advanced users whether authorization succeeded.

Interpreting the Result

The “authorize” command returns an exit code indicating the outcome:

• 0 – Authorization successful. Your account is now linked. No further action needed.
• 1 - Operation cancelled by user
• 2 – Invalid credentials. The username or password is incorrect.
  • Double-check your username and password.
  • Try logging in via the regular UI to confirm your credentials.
  • Run the authorize command again with the corrected values.
• 3 – Motion Engine connection error. D-BOX HaptiSync Center was unable to connect to D‑BOX Motion Engine.
  • Try launching the D-BOX HaptiSync Center UI so it can start the D-BOX Motion Engine service.
  • Confirm the D‑BOX Motion Engine service is running.
  • Once Motion Engine is reachable, run the authorize command again.
• 4 – Authorization server error. There was a problem contacting the authorization service, or the service reported an error.
  • Check the PC’s internet connection.
  • Ensure any firewall or proxy allows outbound communication.
  • Try again later.
• 5 - Authorization timed out. Authorization did not complete within the allotted waiting window.
  • Check the PC's internet connection.
  • Ensure any firewall or proxy allows communication.
  • Try again later.
• 99 - Unexpected Error
  • Run the authorize command again.
  • If the problem persists, contact D BOX support.

Security Notes

• Your username and password are only used by D‑BOX first-party applications (D-BOX HaptiSync Center and D-BOX Motion Engine).
• D-BOX never store or log user credentials. They are used only for the duration of the authorization request and are not persisted anywhere on our servers.
• If using unattended login in scripts:
  • Avoid storing passwords in plain text where others can read them.
  • Restrict file and script permissions to trusted administrators only.

When to Use Unattended Login

Use unattended login when:

• You are deploying multiple PCs and need to pre-link them to a D‑BOX Connect account without manual UI interaction.
• You are running D-BOX HaptiSync Center on systems that are not easily accessible (e.g., racks, remote setups, kiosks).
• You prefer fully scriptable/automated setup steps for your environment.

Use the regular UI login instead if:

• You are on a single user-facing machine where interactive login is easy.
• You are not comfortable using the command line.

Important Notes

• Authorization expiration: The authorization granted by the authorize command expires after 1 year (refresh token expiration). After this period, the PC will no longer be automatically authorized.
• Renewing authorization: You can invoke the authorize CLI command at any time to renew the authorization — you do not have to wait for it to expire. Simply run the same command with your credentials to refresh the token.