VHVox
Help Center

VHVox Support

Everything you need to get started and troubleshoot common issues.

Quick Start

1
Launch VHVox and grant microphone access when prompted. This is required for avatar lip-sync animation.
2
Import your avatar images. Right-click a state slot in the sidebar and select "Import image." Add a mouth-closed image first, then optionally a mouth-open image for lip-sync.
3
Enable the microphone by clicking the mic icon in the bottom bar. Speak and watch your avatar react. Adjust the threshold slider until the animation feels responsive.
4
Set your background and motion. Click the Background button to choose Transparent, Green or Blue chroma key, or a custom image. Then pick a Motion visualizer style — Bars, Circular, or Waves — and customize its color preset and sliders.
5
Record your session — no OBS needed. Hit Record and choose your canvas ratio: 16:9 for YouTube, 9:16 for TikTok and Reels, or 1:1 for square formats. VHVox captures avatar, background, visualizer, and audio into one ready-to-upload file.

Stream Deck Setup

1
Install the VHVox plugin from the Elgato Stream Deck Store. Search for "VHVox" in the Store tab.
2
Make sure VHVox is running. The plugin connects via a local WebSocket — the app must be open for buttons to work.
3
Drag actions to your deck. Available: Avatar State (1–8), Next State, Record, Stop, and Mute.
4
Configure Avatar State buttons. Select which state number (1–8) each button should activate in the settings panel.

Frequently Asked Questions

No — that's exactly why VHVox exists. Hit Record, choose your ratio, and VHVox captures everything into one video file. No OBS, no screen capture tools, no post-production. If you do stream live, VHVox also works as a window source inside OBS.

Check that the mic icon in the bottom bar is green. If gray, click it to start listening. If it stays gray, go to System Settings → Privacy & Security → Microphone and grant VHVox permission. Then lower the threshold slider until speech triggers the animation.

Yes. Switch the audio source to System Audio — your avatar and visualizer react to any sound on your Mac. Choose Both to blend your voice with system audio. No virtual cables required. macOS will ask for Screen Recording permission the first time, which is safe to grant.

16:9 (1920×1080) for YouTube and widescreen. 9:16 (1080×1920) for TikTok, Reels, and Shorts. 1:1 (1080×1080) for Instagram feed. VHVox repositions your avatar and visualizer automatically when you switch ratios.

Set VHVox background to Transparent or a chroma key color. In OBS, add a Window Capture source and select VHVox. Apply a Chroma Key filter if using a colored background. For most recording needs, VHVox's built-in recorder is all you need.

VHVox must be running for buttons to work. If it's open and still unresponsive, remove the buttons and re-add them from the VHVox category. Make sure the plugin is up to date in the Stream Deck Store.

Bars — vertical frequency bars. Circular — radial sunburst ring with avatar centered. Waves — smooth flowing waveform lines. Each has color presets (Neon, Fire, Ice, Galaxy, Lime, Sunset) and sliders for position, intensity, opacity, and size.

PNG, JPEG, GIF, WebP, BMP, and TIFF. Use PNG with transparent backgrounds for the cleanest look. Each state can have mouth-closed and mouth-open images. Animated GIFs work for idle blinking or looping expressions.

Up to 8 states in a 2×4 grid. Each is an independent avatar look. Switch with keyboard shortcuts 1–8, Stream Deck, or by clicking the slot. You can name and color-label each state.

By default in your Movies folder — you can change the destination in Settings. Files are standard MP4 (H.264/H.265) or MOV (ProRes). Nothing is ever uploaded to any server.

Yes — native Universal Binary. Full performance on every M-series chip, no Rosetta. Intel Macs with macOS 13 Ventura or later are also supported.

No. Everything is processed locally on your Mac. No analytics, no tracking, no data transmission. Read our Privacy Policy for details.

Still need help?

✉

We're here for you

Reach out and we'll get back to you as soon as possible.

Email Support

VHVox is a product of Punky Tiger Labs Inc.