Getting Started

This tutorial connects VTube Studio on your PC to VParamix, adds VTube Studio Mobile as the face-tracking input, and sends one moving parameter back to your model.

Before you begin

You need:

• VParamix and VTube Studio running on the same PC;
• a model open in VTube Studio;
• VTube Studio Mobile running on an iOS or Android device;
• the mobile device and PC connected to the same private network.

Allow VParamix through Windows Firewall on your private network when Windows asks. Public-network access is not required for a normal home setup.

1. Connect VTube Studio

1. Open VTube Studio on your PC and load your model.
2. Open VTube Studio settings and enable its API so plugins can connect.
3. In the VParamix connection bar, select VTube Studio as the output.
4. Keep the default address localhost:8001, then turn on the connection.
5. Approve the VParamix plugin request in VTube Studio.

The output connection should now show as connected. See VTube Studio Output Connection for the detailed setup.

2. Connect face tracking

1. Open VTube Studio Mobile and enable 3rd Party PC Clients.
2. Find the mobile device's local IP address in VTube Studio Mobile.
3. In VParamix, select VTube Studio (Mobile) as the Face Tracking input.
4. Enter the mobile device's IP address and keep port 21412 unless you changed it in VTube Studio.
5. Turn on the Face Tracking connection.

Choose the guide for your device:

3. Confirm tracking in Model Studio

1. Open Sources → Face Tracking.
2. Select the bundled VTS Compatible preset if no preset is active.
3. Open Model Studio, then move your head, blink, and open your mouth.

The preview and live parameter values should respond to your face. If they do not, check the mobile IP address, local network, 3rd Party PC Clients setting, and Windows Firewall.

4. Enable output parameter

1. In the Output panel, expand Face Tracking.
2. Enable FaceAngleX.
3. Move your head from side to side and confirm that its live value changes.

Only enabled Output parameters are sent to VTube Studio.

5. Map the parameter in VTube Studio

1. Open your model's parameter settings in VTube Studio.
2. Choose the Live2D parameter that should follow your head angle.
3. Select the FaceAngleX input supplied by the VParamix plugin.
4. Move your head and confirm that the model responds.

You now have a complete path:

VTube Studio Mobile → VParamix Face Tracking → Output → VTube Studio model

Improve the result

Use Calibration when an expression feels weak or never reaches its full range. Use Model Studio to inspect blendshapes, record tracking, test presets, and edit mappings.

Continue exploring