Settings Guide - Complete Reference

How to open

Open Settings from the VSA sidebar.

Settings screen

🏠 Document Top ⚖️ Terms of Service 🔒 Privacy Policy

The Settings panel allows you to customize VSA’s appearance, behavior, integrations, update checks, and user-facing legal/support information.

Accessing Settings

Click the gear icon (⚙️) in the sidebar to open the Settings screen.

The left menu includes these panels:

  1. System - startup and background behavior
  2. Appearance - theme, color, and language
  3. Animation - motion and transition settings
  4. Game Settings - watched folders, OSC, Virtual Desktop, and Steam integration
  5. Notification - notification settings
  6. Shortcut - keyboard shortcuts
  7. X Post - posting presets and posting-related settings
  8. Favorites - favorites management
  9. Update - update checks and release notes
  10. Other - terms, privacy policy, licenses, external links, and important notices

System Panel

Appearance Panel

Configure how VSA looks and displays information.

Theme Settings

Choose the visual theme for the application.

Theme Options:

How to Change:

  1. Select your preferred theme
  2. Changes apply immediately with smooth fade transition
  3. Window content updates in real-time

Language Setting

Choose the UI language for the entire application.

Available Languages:

How to Change:

  1. Select language from dropdown
  2. Application UI updates immediately
  3. All dialogs and tooltips change to selected language
  4. Setting persists across sessions

Note: Documentation language can be set independently in the Documents panel.

Theme Color Selector

Choose an accent color for the application interface.

3 Preset Colors Available:

How to Use:

  1. Click on desired color swatch
  2. Color preview appears in real-time
  3. All UI elements (buttons, accents, highlights) change immediately
  4. Selection applies to entire application

Animation Effects:

Animation Panel

Control visual effects and transitions throughout the application.

Animation Effects Toggle

Enable or disable UI animations and transition effects.

When Enabled:

When Disabled:

Use Cases:

Notification Panel

Configure desktop notifications and alerts.

Desktop Notifications

Control whether VSA sends Windows notifications.

Enable/Disable:

Notification Types

Choose which events trigger notifications:

Import Notifications:

Photo Import In-Progress:

Compression Complete:

Error Notifications:

VRChat Startup/Shutdown:

Notification Sound

Enable/Disable Sound:

Volume Control: (if available)

Notification History

Use the notification button in the footer to review photo-import and background-task notifications. History is stored on the device and can be removed one item at a time or cleared at once.

Shortcut Panel

Manage keyboard shortcuts for frequent operations.

Implemented Shortcuts (4 total)

Display Operations:

Customizing Shortcuts

How to Change a Shortcut:

  1. Locate the shortcut you want to change
  2. Click on the shortcut field (becomes highlighted)
  3. Enter your new key combination:
    • Press and hold modifier keys (Ctrl, Shift, Alt, Win)
    • While holding modifiers, press your desired key
    • Release all keys
  4. New combination displays in the field
  5. Click “Save” to confirm

Example Combinations:

Resetting to Defaults

Reset All Shortcuts:

  1. Open Settings > Shortcut panel
  2. Click “Reset to Default” button
  3. Confirm in dialog
  4. All shortcuts return to default values

Warning: This action cannot be undone. Note current customizations if needed.

See Keyboard Shortcuts Complete List for detailed information.

Game Settings Panel

Configure folders, OSC, Virtual Desktop, and Steam integration for VRChat.

Virtual Desktop auto-launch

On Windows, enable Launch VRChat when Virtual Desktop connects to launch Steam VRChat after the Virtual Desktop Streamer and headset connection are confirmed. It is off by default and VSA must be running.

Steam integration

Enable Start VSA with VRChat (Steam) to add VSA to Steam VRChat’s Launch Options (App ID 438100). Existing safe arguments are preserved. If Steam-side options were changed outside VSA, VSA does not overwrite them. Disabling the integration or uninstalling VSA restores VSA-managed options when they have not been changed.

Favorites Panel

Manage favorites data and legacy folder migration.

Favorites Folder Migration

Purpose: Move favorites data from old locations to new database.

Legacy Folder Import:

  1. Click “Import Legacy Folder”
  2. Select old favorites folder location
  3. VSA imports all legacy data
  4. Favorites appear in Favorites view

Note: Modern VSA uses SQLite database for favorites. Legacy folder migration preserves existing data.

Database Management

View Favorites Database:

Backup Favorites:

  1. Locate %APPDATA%\VSA\favorites.db
  2. Copy to safe location
  3. Keep as backup

Restore from Backup:

  1. Copy backup file to %APPDATA%\VSA\
  2. Overwrite current favorites.db
  3. Restart VSA

See Favorites Guide for complete favorites information.

Update Panel

Control automatic update checking and version information.

Auto-Update Check

Enable/Disable Checking:

Version Information

Current Version Display:

External Links:

Update Notifications

When new version available:

Other Panel

The Other panel collects user-facing documents and notices.

Terms, Privacy, and Licenses

You can open:

You can open:

Important Notices

The panel summarizes:

Resetting All Settings

Reset to Defaults:

  1. Settings > scroll to bottom
  2. Click “Reset All Settings” button
  3. Confirm in dialog
  4. All settings revert to default values
  5. Application restarts automatically

Warning: This action cannot be undone. All customizations will be lost.

Settings Storage

Settings are stored in:

%APPDATA%\VSA\settings.json

Backup Settings:

  1. Navigate to %APPDATA%\VSA\
  2. Copy settings.json to safe location
  3. Keep as backup before major changes

Restore Settings:

  1. Copy backup settings.json to %APPDATA%\VSA\
  2. Overwrite current file
  3. Restart VSA

Tips