Control with Stream Deck
Switch VCamNova’s scenes, avatars, expressions, motions, camera, and more from Stream Deck keys, and see on the keys what VCamNova is showing. You don’t need to bring VCamNova to the front, so you can keep using OBS or a game while you stream.
Stream Deck talks to VCamNova through the VCam API. With VCam, which doesn’t offer the VCam API, send the keys you set for shortcuts with Stream Deck’s “Hotkey” action instead.
Setting up
Section titled “Setting up”- In the Stream Deck app, search Marketplace for “VCam” and install the plugin. You can also download the
.streamDeckPluginfile from the GitHub releases and open it to install. - Open the settings from the ⚙️ button in VCamNova, and turn on “Enable” under VCam API in the “Integration” tab.
- In the Stream Deck app, drag a “VCam” action onto a key, and choose the scene, expression, or other item in the settings on the right.
The lists of scenes, expressions, and other items are read from VCamNova, so open VCamNova before you set up the keys.
Actions
Section titled “Actions”| Action | When pressed | Key lights up while |
|---|---|---|
| Scene | Switches to the scene | The scene is showing |
| Avatar | Switches to the avatar | The avatar is showing |
| Expression | Puts on the expression, or takes it off | The expression is on |
| Motion | Plays the motion, or stops it | It’s playing |
| Shortcut | Runs a VCamNova shortcut | It’s running |
| Recording | Starts or stops recording | Recording (the elapsed time also appears) |
| Emoji | Shows an emoji over the avatar | |
| Subtitle | Shows the text as the subtitle, or hides it | The subtitle is showing |
| Object Visibility | Shows or hides an object in the scene | The object is showing |
| Video | Plays a video in the scene, or pauses it | It’s playing |
| Camera Preset | Moves the camera to the saved view | |
| Reset Camera | Puts the camera back where it was | |
| Background Color | Changes the canvas background color | |
| Tracking Status | Nothing | A source such as VMC Protocol is connected |
The keys follow changes you make in VCamNova itself, too.
An expression key sets the whole face, so pressing one takes off the other expressions.
For Scene, Expression, Object Visibility, and Camera Preset, you can choose in the settings how many seconds the fade or move takes.
On the dials of Stream Deck +, “Zoom” moves the camera closer or farther, and “Expression Weight” changes how strongly an expression shows. Pressing either dial puts it back.
Camera Preset
Section titled “Camera Preset”Press and hold the key to save the camera’s current view. A checkmark appears on the key when it’s saved. You can also save it with “Save the current view” in the settings.
Press the key briefly to move the camera to the saved view.
Badges on keys
Section titled “Badges on keys”A badge in the top-right corner of a key means the key can’t be used right now. Pressing a key with a badge shows a warning sign on it.
- Gray plug: Stream Deck can’t connect to VCamNova. Open VCamNova and turn on the VCam API. The keys work again as soon as it connects.
- Orange up arrow: The connected VCamNova is too old for this action. Update VCamNova.
The reason also appears at the top of the key’s settings.
Controlling VCamNova on another computer
Section titled “Controlling VCamNova on another computer”If Stream Deck is connected to a different computer from the Mac running VCamNova, enter the address in “Connection” in the action’s settings.
- In VCamNova’s settings, turn on “Allow connections from other devices.” See Connecting from other devices.
- In the action’s settings in Stream Deck, open “Connection,” then enter the IP address of the Mac running VCamNova in “Host,” and the token shown in VCamNova’s settings in “Token.”
The connection settings are shared by all VCam keys.
