Settings
Every Settings category and card, with the fields each one holds and their defaults
Every card on the Settings tab, category by category, with what it holds. Type in Search settings to jump straight to a card.
Right-click the Settings tab in the dock to open any card from its menu.
Connections
Link your live platforms, VTube Studio and other apps. Each card shows whether it is connected.
Live platforms
| Card | Fields | Defaults |
|---|---|---|
| TikTok LIVE | TikTok Username, Rejoin the LIVE automatically, Wait for the LIVE to start, Refresh gift list, Connect to LIVE | Both switches on |
| Advanced TikTok connection: Connection Type, WebSocket Host, WebSocket Port | Built-in bridge (Vfinity); localhost, 21213 for a custom connector | |
| Twitch | Connect to Twitch, Channel to watch, Connect on launch, Sign out | Channel to watch empty uses your own channel |
| Kick | Channel name, Chatroom ID, Connect on launch, Connect to Kick | Chatroom ID is found automatically |
| Local KICK sign-in setup: Client ID, Client secret, Callback URL | Optional; only needed to send chat | |
| YouTube | Channel or stream link, Connect on launch, Connect to YouTube | Connect on launch off |
Connection Type offers Built-in bridge (Vfinity) or Custom WebSocket (TikFinity or other); disconnect first to change it. The two rejoin switches work with the built-in bridge only. Refresh gift list appears once the LIVE room is joined.
YouTube needs no sign-in and no API key. An @handle or channel link joins whatever you are streaming, and a stream link joins that one stream; once connected, the card shows Watching: with the stream's title. Vfinity only reads YouTube chat and cannot send messages there.
Apps
| Card | Fields | Defaults |
|---|---|---|
| VTube Studio API | IP Address, Port, Connect VTS | localhost, 8001 |
| OBS Studio | Control OBS, IP Address, Port, Server password, Connect to OBS | Off; 127.0.0.1, 4455 |
| Streamer.bot | Connect to Streamer.bot, IP Address, Port, Server password, Connect Streamer.bot | Off; 127.0.0.1, 8080 |
Passwords stay on this PC and join a backup only with Include passwords and tokens.
Advanced
| Card | Fields | Defaults |
|---|---|---|
| Local server | Shared server port, Enable local API, API access token, Generate token, Let OBS on another PC use these overlays, Access key, New access key | Port 21424; API and LAN access off |
| Trigger API | Trigger API switch, WebSocket Host, WebSocket Port, Connect API | Off; localhost, 8080 |
A new port and LAN access take effect after a restart. See Ports and Overlay URLs.
Automation & rules
Rules that apply to every trigger, plus keys that work from any window.
| Card | Fields | Defaults |
|---|---|---|
| Viewer controls | Blocked @handles, Seconds between triggers, per viewer, Reset history… | Nobody blocked; 0 seconds |
| Global hotkeys | Add a hotkey, Add panic hotkey, Add pause toggle | No hotkeys; up to 32 |
| Keyboard actions | Allow Events to press keys | Off |
Blocked viewers, up to 1,000, cannot trigger actions, use TTS or appear in overlay chat; their earlier activity still counts on leaderboards. The per-viewer wait leaves gifts out. Reset history… resets trigger milestones and first-chat history. Allow Events to press keys lets Press keys steps run. See Keyboard shortcuts for the suggested hotkeys.
Audio
Choose which speakers play the app's sounds, whether TTS and alerts play here or in OBS, and the voice that speaks.
| Card | Fields | Defaults |
|---|---|---|
| Sound output | Output device, Per kind of sound, Test tone, Show device names | System default |
| Where sounds play | Play TTS in, Alert sounds | This app; OBS only for alert sounds |
| Voice | Provider, API key, Model ID, Voice, Custom voice ID, Pitch | Microsoft Edge (free), en-US-AriaNeural |
| Events lines: Volume, Speed, Test | 100%, +0% |
Per kind of sound sends Text-to-speech, Alert sounds in the app, Throw and hit sounds or Previews in settings to a device of its own. Choosing a device works on Windows only; on macOS and Linux the card says so.
Play TTS in offers This app, OBS audio source and This app and OBS. Alert sounds offers OBS only, This app only and OBS and this app.
Voice is the one voice chat, alerts read aloud and Events lines all speak with. API key appears for paid providers, Model ID for those with models to pick, Custom voice ID for Fish Audio, and Pitch for Edge and Murf. Events lines sets the volume and speed of speech steps that set none of their own; chat keeps its own in Chat TTS on the Overlay tab. See Text to speech and TTS providers.
Appearance & language
| Card | Fields |
|---|---|
| Language | English, ไทย, 中文, 日本語, हिन्दी, Español |
| Appearance | The Vfinity, Glass and Potato themes, your own themes, and Open theme studio |
Points
How viewers earn points, and what events from each platform are worth.
| Card | Fields | Shown |
|---|---|---|
| Points economy | Award points, Call them, Per like, Per comment, Per share, Per follow, Per subscribe, Per join, Per diamond | Always |
| What events are worth | Diamond values for bits, channel points, subs, Kicks, Kick rewards, Super Chats and gifted YouTube memberships | Once Twitch, Kick or YouTube has connected |
Each platform's rates appear once that platform has connected. Diamonds per US$ of Super Chat is 140 to start, converted from the viewer's currency. Gifted YouTube membership is 700 to start, and the gift counts as a "Gift Sub", the same name gifted subs have on Twitch and Kick. Points lists every rate and its default.
Preferences & data
Profiles, startup and desktop behavior, and backups of your setup.
| Card | Fields | Defaults |
|---|---|---|
| Stream profiles | Save, switch, update and delete profiles | None |
| Global Preferences | Connect on launch, Verbose logging | On; off |
| Desktop and tray: Start Vfinity when I sign in, Start minimized to tray, Close button keeps Vfinity in the tray, Minimize to tray, Closing while live | Tray options off | |
| Data Management | Export backup, Import backup, Share mappings or a widget | — |
A profile saves your events, throwing scene and overlays for one model or stream; switching reloads Vfinity, and connections are shared by every profile. Closing while live decides what the X does while a live platform or VTube Studio is connected: Ask every time, Quit or Keep running in tray. Files and backups lists what a backup holds.