Profiles

What Are Profiles?

A profile is a named snapshot of your entire VMSC configuration. Each profile stores its own independent copy of:

• Rules — all rule definitions, filters, cooldowns, and accumulators
• Actions — the action chains attached to each rule
• Goal Trackers — goal configurations, current progress, and target values
• Overlay Layouts — widget positions, styles, and content assignments
• Output Settings — VRChat OSC parameters, PiShock device mappings, script paths

When you switch profiles, VMSC unloads the current configuration and loads the selected one. Your stream connection stays active — only the rules, actions, and related settings change.

The Default Profile

Every VMSC installation starts with a Default profile. This is the profile that loads automatically when the application starts. It works exactly like any other profile — you can edit its rules, actions, and settings freely.

Creating a Profile

To create a new profile:

1. Open the Settings tab in the sidebar.
2. Scroll to the Profiles section.
3. Click the + New Profile button.
4. Enter a name for the profile (e.g., "Horror Game Stream").
5. Click Create.

The new profile starts with an empty configuration — no rules, no actions, and default output settings. You can begin building rules from scratch, or duplicate an existing profile to start from a working base.

Naming Conventions

Profile names can contain letters, numbers, spaces, and common punctuation. Choose descriptive names that help you identify the profile at a glance:

• Default — your everyday stream setup
• VRChat - Dance Party — rules tuned for dance stream events
• PiShock Challenge — aggressive shock triggers for challenge content
• Chill Stream (No Shocks) — relaxed rules with PiShock disabled

Switching Profiles

You can switch profiles at any time, including during a live stream. The transition is instantaneous and does not interrupt your TikTok connection.

1. Open the Settings tab.
2. In the Profiles section, find the profile you want to activate.
3. Click the profile name or the Activate button.
4. VMSC saves any unsaved changes in the current profile, then loads the selected one.

What Changes When You Switch

When you activate a different profile, the following components swap out immediately:

What Stays the Same

These components are global and do not change between profiles:

• TikTok Connection — your live stream connection remains active
• Viewer Database — viewer history, chat logs, and stats persist across all profiles
• Application Settings — window position, theme, language, and general preferences
• License Status — your license tier and activation state

Duplicating Profiles

Duplicating a profile creates an exact copy of all its rules, actions, goals, and settings. This is the fastest way to create a new profile based on an existing one.

1. In the Profiles section of Settings, find the profile you want to copy.
2. Click the three-dot menu (…) next to the profile name.
3. Select Duplicate.
4. Enter a name for the duplicate (the default is the original name with "Copy" appended).
5. Click Create.

The duplicate is an independent copy. Changes to the duplicate do not affect the original profile, and vice versa.

Import & Export

Profiles can be exported to a file and imported on another machine or shared with other VMSC users. This is useful for:

• Backing up your configuration before major changes
• Moving your setup to a new computer
• Sharing a curated rule set with a friend or community

Exporting a Profile

1. In the Profiles section, click the three-dot menu next to the profile.
2. Select Export.
3. Choose a save location. The file is saved as .vmsc-profile (a JSON file with VMSC metadata).

The exported file contains the complete profile data: rules, actions, filters, cooldowns, goal configurations, and overlay layouts. It does not include sensitive data such as PiShock API keys or license information.

Importing a Profile

1. In the Profiles section, click Import Profile.
2. Select a .vmsc-profile file from your file system.
3. VMSC validates the file and shows a preview of what will be imported (number of rules, overlays, etc.).
4. Enter a name for the imported profile (or keep the original name).
5. Click Import.

Export File Format

The .vmsc-profile file is a standard JSON file with the following top-level structure:

{
  "vmscVersion": "1.2.0",
  "profileVersion": 1,
  "name": "My Stream Profile",
  "exportedAt": "2026-03-15T14:30:00Z",
  "rules": [ ... ],
  "goals": [ ... ],
  "overlays": [ ... ],
  "outputSettings": { ... }
}

You can inspect or hand-edit the JSON if needed, but modifying it incorrectly may cause import validation to fail.

Managing Profiles

Renaming a Profile

Click the three-dot menu next to any profile and select Rename. Type the new name and press Enter to confirm. Renaming does not affect the profile's data.

Deleting a Profile

Click the three-dot menu and select Delete. A confirmation dialog appears to prevent accidental deletion. Deleted profiles cannot be recovered unless you have an exported backup.

Best Practices

• Export regularly. Before making significant changes to a profile, export a backup. This gives you a restore point if something goes wrong.
• Use descriptive names. When you have many profiles, clear names prevent confusion during a live stream.
• Keep a clean base profile. Maintain one profile with your core rules and outputs configured correctly. Duplicate it as the starting point for specialized profiles.
• Test before going live. After switching profiles or importing one, use the Dev Test Panel to simulate events and verify that your rules and overlays behave as expected.
• Share with caution. Exported profiles do not contain API keys, but they do contain your rule logic, overlay layouts, and goal structures. Only share with people you trust.

Quick Reference