🗣️ Avatar Guide: Make it Talk!

This guide will help you create a basic and very simple “2-Frame” avatar (Mouth Closed / Mouth Open) that reacts when VoxAI speaks.

How it works:

1. VoxAI sends audio to a “Virtual Cable”.
2. OBS listens to that cable.
3. The Move Plugin hides/unhides your “Open Mouth” image based on the volume.

Before opening OBS, download and install these two required tools.

1. The Audio Driver (Virtual Cable) This allows VoxAI to “talk” directly to OBS without your microphone picking it up.

• Download: VB-Audio Cable
• Action: Install it, then RESTART YOUR COMPUTER. (Do not skip the restart!)

2. The OBS Move Plugin This handles the animation logic.

• Download: OBS Move Plugin
• Action: Download the installer for your OS and run it.

3. Your Art You need two PNG images with transparent backgrounds:

• ``avatar_closed.png`` (Mouth Closed)
• ``avatar_open.png`` (Mouth Open)

Open OBS and follow these steps exactly.

A. Add the Images

1. Add your Mouth Closed image to the scene.
2. Add your Mouth Open image to the scene.
3. Important: Ensure the “Mouth Open” layer is ABOVE the “Mouth Closed” layer in the sources list.
4. Click the Eye Icon 👁️ next to the Mouth Open layer to hide it. (It should be invisible by default).

B. Add the Audio Source

1. In Sources, click + and select Audio Output Capture.
2. Name it “VoxAI Audio”.
3. Device: Select “Cable Input (VB-Audio Virtual Cable)“ (or similar).

This is where the magic happens. We will tell OBS: “When the audio gets loud, show the open mouth.”

1. Right-click your new VoxAI Audio source and select Filters.
2. Click + and select Audio Move.
3. Configure the settings exactly as shown below:

Pro Tip: If the mouth isn't opening, lower the Threshold. If it gets stuck open, raise the Threshold slightly (e.g. to 5.00 or higher depending on volume).

Now tell VoxAI to use that special cable we installed.

1. Open VoxAI.
2. Go to Audio > Audio Output.
3. Select “CABLE Input (VB-Audio Virtual Cable)“.
   • Note: The name might be cut off, looking like “CABLE Input (VB-Audio…”.

1. Type “Hello” in VoxAI.
2. Watch OBS.
3. You should see the VoxAI Audio bar move, and your avatar's mouth should open and close with the voice!

Can't hear the bot?

This is because the audio is going to the Virtual Cable, and not going to your speakers (as intended). To hear it yourself:

1. In OBS, click the Gear Icon ⚙️ in the Audio Mixer next to “VoxAI Audio”.
2. Select Advanced Audio Properties.
3. Change “Audio Monitoring” to Monitor and Output.

Note: You will not be able to hear your bot unless OBS is open. This is because the audio source is not playing anywhere else where you can hear it.