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.

This guide describes the Settings screen in VSA v0.9.0.

Accessing Settings

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

The left menu normally contains 11 panels. When Developer Mode is enabled, VR Mode appears after Notification and before Shortcut. When the cloud UI is available, X Post appears after Shortcut.

  1. System - startup and background behavior
  2. Application Info - version, connection, and photo-watcher status
  3. Appearance - theme, color, and language
  4. Animation - motion and transition settings
  5. Game Settings - watch, output, and log folders plus OSC
  6. Notification - notification settings
  7. Shortcut - keyboard shortcuts
  8. Favorites - favorites management
  9. Tutorials - launch or replay in-app tutorials
  10. Update - update checks and release notes
  11. Other - terms, privacy policy, licenses, external links, and important notices

System Panel

Start Photographer Mode from the VR icon in the title bar to review newly captured photos full screen. See the Photographer Mode Guide for the full-screen controls.

Developer Mode

Enable Developer Mode in the System panel to show the Developer menu. The VR Mode panel is also shown only while Developer Mode is enabled.

Application Info Panel

Review the installed version, VRChat connection, and photo-watcher status. Use the refresh button to retrieve the connection status again.

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. Most translated text updates to the selected language; some content may remain in Japanese
  4. Setting persists across sessions

Note: Some interface text may still appear in Japanese.

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 notification methods, event types, and notification sound.

Notification Methods

Toggle OS notifications and in-app toast notifications independently.

Allow VSA notifications in Windows settings when using OS notifications.

Notification Types

When either notification method is enabled, configure these events independently:

Sound

Turn on Play notification sound to play a sound when a notification is shown. There is no volume slider or notification-history setting in this panel.

Open the bell icon in the bottom status bar to review notification history. Opening it marks the current items as read; there are no per-item delete or clear-all controls.

VR Mode Panel

This panel appears after Notification and before Shortcut when Developer Mode is enabled. VR Mode is a beta feature; read the in-app notice before using it.

Shortcut Panel

Manage keyboard shortcuts for frequent operations.

Implemented Shortcuts (9 total)

Display Operations:

Check the Shortcut panel for the current binding for rotation before using it.

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. The new binding is saved automatically; there is no Save button.

Example Combinations:

Resetting to Defaults

Reset All Shortcuts:

  1. Open Settings > Shortcut panel
  2. Click Reset all
  3. 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

The Game Settings panel in Settings contains the sidebar Game Settings Display Settings: watch, output, and log folders plus OSC. Switches and fields save automatically; there is no manual Save button.

Configure Steam, Virtual Desktop, and VRChat outage notifications in Game Settings > Plugins. Review the event history in its Time Machine tab.

The Steam plugin details show its current operation and the launch options passed to VRChat. If Steam settings changed elsewhere, VSA displays a warning and does not overwrite them automatically.

Favorites Panel

Choose the folder used to keep copies of favorite photos and migrate existing favorites.

Favorites Folder Migration

Purpose: Copy existing favorite photos to the selected favorites folder.

Steps:

  1. Choose a folder under Save destination folder
  2. Click Migrate favorite photos
  3. Review the successful and failed counts and any failed-photo details

When you mark a photo as a favorite, VSA copies the original to the configured folder. Removing one favorite with the star button in the detail sidebar deletes the tracked copy. Bulk removal in Favorites selection mode only clears favorite status and leaves both the original and the copy.

See Favorites Guide for complete favorites information.

Tutorials Panel

Select a tutorial to start or replay it in the app. A check mark identifies completed tutorials. Tutorial content is currently shown in Japanese.

Update Panel

Check the installed version, check for updates, and open release notes.

Check for Updates

Click Check for updates to look for a newer version. When one is available, review the details and download it to restart VSA.

Version Information and Release Notes

Current Version Display:

Click Release notes to open the notes for the current version. External links such as GitHub Releases and documentation are in the Other panel.

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:

Returning Settings to Defaults

There is currently no single button that resets every setting. Use the reset action provided by the relevant screen:

Do not delete or replace VSA-managed data manually. If the problem persists, contact support with the log and symptoms.

Saving Settings

Settings are saved automatically when a panel value changes. Folder selections and migration results are reported in the app; there is no general Save button. Do not edit or replace settings files manually.

Example Configurations

Working in a dark environment

  1. Set the theme to Dark.
  2. Choose a darker theme color preset if desired.
  3. Disable animations if performance is limited.

Reducing load on an older PC

  1. Disable animations.
  2. Disable automatic opening of new photos in Settings > VR Mode if it is not needed.
  3. Enable automatic archiving of older photos when storage management is a priority.

Customizing shortcuts

  1. Open the Shortcut panel.
  2. Select the shortcut to change.
  3. Enter the new key combination.
  4. The accepted combination is saved automatically; there is no Save button.

Troubleshooting

A setting does not take effect

Restart VSA after changing the setting. If the value still has no effect, use the reset action in the relevant panel and try again.

A setting does not persist

Check write permission for %APPDATA%\\VSA\\ and available disk space. If the problem continues, contact support with the log and the steps that reproduce it.

Settings Storage

Settings are saved automatically as each panel changes. Do not edit or replace settings files manually. If a setting does not persist, verify folder permissions and free disk space, then contact support with the log and symptoms.

Tips