Diagnostics & fixes

Troubleshooting

Quick fixes for the most common capture, network, and sharing problems.

Factory reset

A factory reset returns the app to its shipped defaults. Choose the least destructive method that matches the problem. A reset can remove settings, datasets, generated assets, queue history, and other local files, so keep a backup before continuing.

These instructions apply to both Virtual.ink and Xangle Camera Server. Replace <app> below with virtualink or cameraserver.

Method 1: Reset from the app

Use this method when the app launches and you can open Troubleshooting from the app menu.

  1. Open Troubleshooting.
  2. Choose Reset all settings to delete saved JSON settings in the active working folder while keeping datasets and assets.
  3. Choose Full wipe only when you also want to remove the local datasets and asset files.
  4. Confirm the action and restart the app if it does not reload automatically.

The reset restores the current shipped defaults. It does not delete files in an external backup destination. When the default working folder is active, the reset also removes its locations.json; when a custom working folder is active, the global locations.json remains in the default app root.

Method 2: Create a new working folder

Use this method when you want a clean workspace but want to preserve the existing workspace for reference.

  1. Open the app's working-folder or location settings.
  2. Add or select a new folder as the active working folder.
  3. Restart the app when prompted.

A new working folder is scaffolded with config and datasets subfolders. The app then reads settings from the new folder instead of the previous one. The old folder remains on disk, so it can be restored later by selecting it again.

Working-folder choices are recorded in the app's global locations file:

  • Virtual.ink: %USERPROFILE%\\xangle\\virtualink\\locations.json
  • Xangle Camera Server: %USERPROFILE%\\xangle\\cameraserver\\locations.json

The active folder can also be a custom path outside these default roots. The locations.json file stays in the default app root even when a custom working folder is active.

Method 3: Rename the working folder in Windows Explorer

Use this method when the app does not launch or its settings UI is unavailable. Close the app completely first.

  1. Close Virtual.ink or Xangle Camera Server.
  2. Open the default app folder:
    • Virtual.ink: %USERPROFILE%\\xangle\\virtualink
    • Xangle Camera Server: %USERPROFILE%\\xangle\\cameraserver
  3. Rename the folder to a backup name, such as virtualink_backup or cameraserver_backup.
  4. Launch the app again.

The app creates a new default folder with a config directory and a datasets directory. Keep the renamed folder until you have confirmed that the app works and that you no longer need its settings or files.

If a custom working folder is active, use the path shown in the app's location settings instead of the default path. Renaming only the default root will not reset that custom folder.

What is and is not reset

The working folder contains the active config and datasets data. Depending on the app and modules in use, it can also contain assets, archives, and backup directories.

  • Reset all settings removes JSON settings files from the active working folder and preserves datasets and assets.
  • Full wipe removes settings, datasets, and local asset contents.
  • Renaming a working folder preserves everything in that backup folder until you delete it.
  • locations.json is stored in the default app root and tracks known working folders and the active custom folder. If a custom working folder is active, reset its location list separately by removing the relevant entries from this file; if the default working folder is active, Reset all settings and Full wipe already remove the file.

Do not delete the default app folder while the app is running. If the app still does not start after a reset, keep the renamed backup and contact support with the application logs.