Troubleshooting Avatar Motion (FAQ)

If your avatar's body, head, or other parts don't move, check the send/receive status and whether other VMC-related apps are conflicting.

• Make sure you are using the latest version of the apps
• Is receiving turned ON in Streaming Mode on the Viewer app?
• Have you gone as far as pressing "Start Sending" in the capture app?
• If both apps run on the same PC, is the capture app's destination IP set to 127.0.0.1?
• Does the VMC Port match between the capture app and the Viewer app?
• Are you running it alongside other VMC-related apps?

First, try it with the unmodified base avatar only. If it still behaves strangely, the avatar itself is the cause, so please contact its creator.

Otherwise, the problem is usually caused by gimmicks or animations included in your modifications. Since we have no way of knowing what modifications you've made, we ask that you investigate this yourself. We recommend starting from the base avatar, adding your modification items one at a time to find the one causing the problem, and then removing it.

If facial expressions don't move, first make sure "Expression" is checked (turned on) in the capture app's parts to send.

Also check the face tracking type and whether anything else is using the VRC OSC Port.

• Check that the face tracking type is correct (VRCFT, etc.)
• The face tracking type supported by the avatar, the Streaming Mode setting on the Viewer app, and the capture app setting must all match
• Are you running it alongside another app that uses the same VRC OSC Port, such as VRCFaceTracking?

How face tracking types map to expression blend shapes

Even for the same "open mouth" or "blink," the blend shape names and parameter names the Viewer looks for depend on the face tracking type. If the avatar has no matching expression, or the expression was made with only a small range of motion, some expressions may not move.

The Viewer app lets you check which face tracking types the currently loaded avatar supports. Before checking the capture app or VRCFaceTracking settings, first make sure the avatar supports that type.

1. Display the avatar in the Viewer app
2. Open Streaming Mode from the toolbar
3. Click the Face Tracking button in Streaming Mode
4. Check what is listed under Available and Unsupported in the window

Yes. With a Face ID-capable iPhone / iPad and iFacialMocap, you can send facial expressions, head orientation, and eye gaze without a webcam.

1. In the capture app's "Camera" dropdown, select "No Camera (Use iFacialMocap)"
2. Turn ON "Use iFacialMocap"
3. Enter the IP address for iFacialMocap and start sending from your iPhone
4. Once the connection status changes to "Receiving," run the initial calibration and start sending

"Start Sending" becomes available once the capture app is receiving valid input. With a webcam, check that the camera has started and the initial calibration is done. With iFacialMocap alone, check iFacialMocap's receiving status.

• When using a webcam Start the camera, and once you appear in the preview, run the initial calibration. If your face or upper body can't be detected, you may not be able to start sending.
• When using iFacialMocap only Set the camera to "No Camera" and make sure iFacialMocap shows as receiving. You can't start sending if no data is being received.
• When using neither There is no valid tracking input, so you can't start sending.

If motion freezes, tracking goes haywire, or the response is unstable, check the input status in the capture app and the smoothing settings in the Viewer app.

• Check that you appear in the capture app's preview and that tracking is working
• If your clothes are close in color to the background, tracking accuracy drops noticeably. Avoid clothes in the same color family as your floor or walls, and wear colors that contrast strongly with the background
• If you want to move your arms, make sure your elbows and arms are within the camera's view
• In the Viewer app, open "Motion Smoothing" in Streaming Mode to adjust each body part, such as the head, body, and hands
• Higher values make motion smoother but slightly slow down the response
• Lower values make the response faster, but motion becomes choppier when the input is noisy
• When using iFacialMocap alone, Wi-Fi latency and packet loss can also make motion unstable. Connect your iPhone and PC to the same network and use as stable a connection as possible
• In VRCFT mode, the expression data and FX parameter movement from the sender take priority over the Viewer's expression smoothing

これはほかの配信者さんにもお伝えしたいのですが、トラッキングを安定させるために、カメラ性能よりも「画角」と「服」が大事でして、

・肘と腕が入るくらいの画角にする(添付画像くらい)
⇒ トラッキングの安定性が上がります

・腕が出る服(半袖とか)を着る
⇒… pic.twitter.com/u5SXE0SPa9

— Rob_VRC (@Rob_VRC) April 22, 2026

There are two main ways to bring the Viewer app into OBS: Spout Output and transparent window capture. We usually recommend Spout Output.

• Turn ON Spout Output in the Viewer app, then add a Spout-compatible source in OBS
• If the source doesn't show up in OBS, check that the Viewer app and OBS are running on the same GPU
• To use transparent window capture, turn ON transparent background mode in the Viewer app
• In the trial version, the "TRIAL" label also remains in the Spout Output

If motion data from your iPhone arrives only for a moment, the status switches to "Receiving" but immediately goes back, or the connection never stabilizes and stays waiting, check the Windows firewall or the local network permission on your iPhone.

Check Windows Defender Firewall

Data from the iPhone may be reaching the PC while Windows Firewall blocks it from being received. This is especially likely if data gets through for just a moment right after the signal that the capture app sends to the iPhone every few seconds.

1. Search for "Firewall" in the Windows Start menu
2. Open the Windows Defender Firewall screen
3. Temporarily turn off the firewall
4. Check whether the capture app's status stays stable at "Receiving"

Check the local network permission on your iPhone

If Local Network access for iFacialMocap is turned off in your iPhone's per-app permissions, it may not be able to communicate even when connected to the same Wi-Fi as your PC.

1. Open the "Settings" app on your iPhone
2. Open "Apps"
3. Select "iFacialMocap" from the list
4. Turn on "Local Network" under "Allow iFacialMocap to Access"
5. Reconnect iFacialMocap and the capture app