Skip to main content

Steam Cloud Settings Configuration

Overview​

vrOS stores user settings in multiple locations to ensure data persistence and enable Steam Cloud synchronization.

Settings Locations​

Primary Location (User-specific)​

  • Windows: %APPDATA%\vrOS\vr\config\
  • Linux: ~/.config/vrOS/vr/config/
  • macOS: ~/Library/Application Support/com.vrOS.vr/

This location is automatically synchronized with Steam Cloud when configured.

Backup Location (Game directory)​

  • {game_install_dir}/userdata/backup/

A backup copy is automatically saved here whenever settings are modified. This ensures settings can be recovered even if the primary location is corrupted or deleted.

Files Synchronized​

Currently synchronized files:

  • dashboard_settings.json - Main dashboard configuration including laser stabilization, grip settings, and UI preferences

Future files:

  • position_presets.json - Custom overlay position presets
  • keybindings.json - Custom keyboard shortcuts and controller bindings

Steam Cloud Configuration​

For Players​

Steam Cloud synchronization happens automatically when enabled in Steam. Your settings will sync across all devices where you play vrOS.

To verify Steam Cloud is working:

  1. Right-click vrOS in your Steam library
  2. Select Properties > Updates
  3. Ensure "Steam Cloud" is checked

For Developers (Steamworks Configuration)​

In the Steamworks partner dashboard:

  1. Navigate to your app's configuration
  2. Go to Steam Cloud > Auto-Cloud Configuration
  3. Add the following path patterns: 
    %APPDATA%/vrOS/vr/config/*.json
    %APPDATA%/vrOS/vr/presets/*.json
  4. Set appropriate file size limits (1MB recommended)
  5. Save and publish changes

Migration from Old Settings​

If you previously used vrOS when it was named "catnet", your settings will automatically migrate from:

  • Old: %APPDATA%\catnet\vr\config\
  • New: %APPDATA%\vrOS\vr\config\

The migration happens automatically on first launch after updating.

Troubleshooting​

Settings not saving​

  1. Check write permissions to the AppData folder
  2. Verify the backup location in game directory
  3. Check vrOS logs for save errors

Steam Cloud not syncing​

  1. Ensure Steam Cloud is enabled for vrOS
  2. Check your Steam Cloud storage isn't full
  3. Verify you're online and connected to Steam

Manual backup/restore​

Your settings can be manually backed up by copying:

  • Primary: %APPDATA%\vrOS\vr\config\dashboard_settings.json
  • Backup: {game_dir}/userdata/backup/dashboard_settings.json

Privacy Note​

Settings files may contain:

  • UI preferences and layout configurations
  • Controller sensitivity settings
  • Position presets for overlays

No personal information or credentials are stored in these files.