Upgrade from 1.x
Move from Vfinity 1.6 or an earlier alpha to 2.0 Alpha, keep your setup, and find what moved
Vfinity 2.0 Alpha installs over 1.6 and picks up your setup where you left it. Make a backup first, install, then spend a minute on what moved and what is new. Updating from an earlier alpha takes the same backup and one refresh in OBS.
2.0 is an alpha
Features may change and bugs are expected. Keep the backup you make below, and test your setup before you go live. Stable 1.6.0 stays on the same itch.io page if you need to go back.
Back up your 1.6 setup
Open Data Management
In Vfinity 1.6, go to SettingsPreferences & data and click Export backup on the Data Management card.
Choose everything
Click Select all so every part goes into the file.
Decide about passwords
Tick Include passwords and tokens only if you want a restore to reconnect VTube Studio, OBS and the rest without asking again. Keep that file private.
Save it
Click Save backup… and keep the file somewhere outside the Vfinity folders.
Choose what goes into the backup file.
Install 2.0
The alpha is a separate download from the free 1.6.0 on the itch.io page, and is bought on its own. Install Vfinity covers each system.
On Windows, the installer finds 1.6 and shows Existing Installation Found. Choose Update - remove the previous version first (recommended). Your settings are not removed with it.
Only one version is installed at a time: 2.0 replaces 1.6.
What carries over
Everything you saved in 1.6 is still there in 2.0: your events, throwing scene and item library, overlays and widget copies, text to speech, stream profiles, hotkeys, themes, stats and point balances.
Your OBS browser source URLs stay the same, and so does the overlay port.
A few things arrive switched on or filled in for you:
- Subscription and Raid alerts are switched on.
- Quick Deck starts with six pads: two spoken lines, Skip alert, Skip speech, and Applause and Laugh, which wait for you to pick a sound.
- The setup wizard does not open for an existing setup. Use Run setup again on the Dashboard to connect Twitch, Kick and YouTube with it.
What moved or was renamed
| In 1.6 | In 2.0 |
|---|---|
| The Streetwear theme | Vfinity, the same theme |
| The Modern theme | Glass, the same theme |
| Global hotkeys, in Preferences & data | SettingsAutomation & rules |
| Allow Events to press keys, on the Connections page | Keyboard actions, in SettingsAutomation & rules |
| Local server, at the top of Connections | SettingsConnections, under Advanced |
| Every connection card in one list | Grouped into Live platforms, Apps and Advanced |
| The text-to-speech voice, provider and API key, in Chat TTS | SettingsAudioVoice |
The window itself is new too. The five tabs, Dashboard, Events, Throwing, Overlay and Settings, sit in a dock along the bottom, and Events, Throwing, Overlay and Settings each show a list beside an editor. The studio tour walks through it.
After you upgrade
Refresh your OBS sources
OBS keeps running the page it loaded until a source is refreshed. Open each Vfinity browser source's properties and click Refresh cache of current page.
Check your connections
Look at the connection pills in the title bar. Reconnect anything that is not connected in SettingsConnections.
Connect Twitch, Kick and YouTube
They are new in 2.0. Connect them on their cards under Live platforms, then set what their bits, subs, Kicks and Super Chats are worth in SettingsPoints, under What events are worth.
Test before you go live
Right-click an event and choose Test it now to check it still reacts the way you expect.
Upgrade from an earlier alpha
Each alpha installs over the last one and keeps your setup. Back up first all the same, since an alpha can still have bugs.
Back up your setup
In SettingsPreferences & data, click Export backup on the Data Management card, click Select all, and save the file somewhere outside the Vfinity folders.
Install the new alpha
Download it from the same itch.io page and install it the way you installed the last one. Install Vfinity covers each system.
Refresh your Vfinity sources in OBS
Do this once after each update, so OBS loads the new overlay pages. Open each Vfinity browser source's properties and click Refresh cache of current page.
Coming from Alpha 0.2.0 or earlier, a few settings have moved:
| In Alpha 0.2.0 | In Alpha 0.4.0 |
|---|---|
| The voice, provider, API key, model and pitch, in Chat TTS | SettingsAudioVoice, shared by chat, alerts and Events lines |
| Play TTS in, in Chat TTS as well as Settings | The Where sounds play card in SettingsAudio |
| One volume and speed for all speech | Chat's in Chat TTS, and Events lines' under Events lines in the Voice card |
Events lines start at the volume and speed your chat had, so nothing sounds different until you change them. What's new lists everything else that changed in each alpha.
Go back to 1.6
Download 1.6.0 from the itch.io page. On Windows, uninstall 2.0 first: the 1.6 installer does not install over a newer version in place. Then install 1.6.0 and restore the backup you made before upgrading, from Import backup on the Data Management card.