Skip to content

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.

  1. In the Stream Deck app, search Marketplace for “VCam” and install the plugin. You can also download the .streamDeckPlugin file from the GitHub releases and open it to install.
  2. Open the settings from the ⚙️ button in VCamNova, and turn on “Enable” under VCam API in the “Integration” tab.
  3. 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.

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.

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.

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.

If Stream Deck is connected to a different computer from the Mac running VCamNova, enter the address in “Connection” in the action’s settings.

  1. In VCamNova’s settings, turn on “Allow connections from other devices.” See Connecting from other devices.
  2. 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.