Files and backups
Where Vfinity keeps your setup on this PC, what a backup holds, and what never leaves the machine
Everything Vfinity knows lives on this PC. A backup packs the parts you choose into one file you can keep, move to another computer, or restore later.
Where Vfinity keeps data
Vfinity's folder is named after its app ID, com.zyphite.vfinity.
| System | Folder |
|---|---|
| Windows | %APPDATA%\com.zyphite.vfinity |
| macOS | ~/Library/Application Support/com.zyphite.vfinity |
| Linux | ~/.local/share/com.zyphite.vfinity, and ~/.config/com.zyphite.vfinity for the small files below |
| Inside it | What it holds |
|---|---|
overlay_assets | The sounds, images and videos you upload, for overlays, alerts, throwing, action steps and Quick Deck pads |
docs/history | Stream history, one file per stream |
overlay_port.txt | The overlay server's port |
overlay_network.json | Whether LAN access is on, and its access key |
desktop_prefs.json | Tray and startup choices Vfinity reads before its window opens |
Everything else, such as your settings, events, throwing scene, themes, widgets and stats, lives in the app window's own storage. Use a backup to move it, rather than copying folders by hand.
What a backup holds
Open SettingsPreferences & dataData Management and choose Export backup. The dialog lists the parts below, with most ticked for you.
| Part | Ticked at first | Holds |
|---|---|---|
| Connections and preferences | Yes | VTube Studio and live-platform connection settings, the API server, auto-connect and debug mode |
| Events mappings | Yes | Every event, switched on or off, with its action steps or its Blueprint |
| Quick Deck | Yes | Your pads, with their sounds and pictures |
| Throwing scene | Yes | Throwable items and the item library, gift throw rules, body parts and the hitbox, with their images and sounds |
| Look and theme | Yes | The active theme, your custom themes, light or dark mode, and the background image |
| Language | Yes | The app's language |
| Overlay widgets | Yes | Every widget's settings, with the files you uploaded for them, your favorites and collections, and saved style presets |
| Interactive widgets | No | Jar contents, poll votes, the viewer queue, giveaway entrants and game scores, with viewer names |
| Stream profiles | Yes | Every saved profile, with its files |
| Text-to-speech | Yes | The voice, provider and reading settings, your laugh styles and laughs, and who has which voice. Never the API keys |
| Stream statistics | Yes | All-time totals and point balances, including the names of your top viewers |
| Points economy | Yes | What each like, comment, share, follow and diamond earns |
| Countdown timer | No | The time left on the countdown. It always comes back paused |
| Global hotkeys | Yes | Your hotkeys and the commands they run |
Choose what goes into the backup file.
Passwords and tokens
These go into a backup only when you tick Include passwords and tokens, so a restore can reconnect without signing in again:
- The VTube Studio token
- The OBS server password
- The Streamer.bot password
- Webhook Authorization header values
- Your Twitch and Kick sign-ins, and the Kick client secret
- The Local API token
Without them, a restore leaves the Local API switched off. Text-to-speech API keys are never included, and a restore keeps the keys already on this PC.
Keep a backup with passwords private
Anyone holding a backup made with Include passwords and tokens can use those sign-ins and control your VTube Studio plugin. Do not share it or upload it anywhere public.
Never in a backup
- Stream history
- This stream's live numbers, and where each goal stands
- Trigger milestones and first-chat history
- How your Dashboard is arranged
- The setup wizard's progress
- Private nicknames you gave viewers in the chat window
Restore a backup
Open the file
In SettingsPreferences & dataData Management, choose Import backup, then Open file…. Vfinity shows which version made the file and when, and what it holds, before anything changes.
Tick the parts to restore
Ticked parts replace what you have now. For Events mappings, choose whether to replace your events or add to them.
Restore
Choose Restore. Some parts apply at once; others reload the app, which then reconnects your services.
| For Events mappings | What happens |
|---|---|
| Replace my mappings | Your events are replaced by the file's |
| Add to my mappings | The file's events go after yours; ones you already have are skipped |
When adding, clashing IDs get new ones. Each VTube Studio hotkey is matched by name to the model loaded now, and events whose hotkey does not match come in switched off.
Share a part of your setup
Share mappings or a widget saves your events, or a single overlay widget with its uploaded files, as a file for someone else. They open it from Import backup; a shared widget changes only that widget.
| File | Made by |
|---|---|
| Backup | Export backup |
| Shared Events mappings | Share mappings or a widget |
| Shared widget | Share mappings or a widget |
| One event | Export in the Blueprint editor |
A single event's file is a shared Events mappings file holding that one event,
with its trigger and the sounds and media it uses. Its name starts with
vfinity-event-, then the event's name and the date. Open it with Import
in any Blueprint, or from Import backup.
Format versions
Backups are written in format 7. Vfinity 2.0 restores formats 1 to 7, so a backup from any earlier version still opens, with defaults filled in for anything newer.