From 6be729d31047fcf42714b82984933c93a20898d9 Mon Sep 17 00:00:00 2001 From: MooshPaw <125221816+MooshPaw@users.noreply.github.com> Date: Tue, 6 Jan 2026 16:07:00 -0500 Subject: [PATCH] Revision for iFacialMocap (iPhone/iPad) instructions Dropping "Under construction" as it's no longer needed Improved application list for iFacialmocap and FaceMotion3D, added disclaimers to them as well Moved step 5 to the top as a TIP Increased spacing on the bulletlist for easier reading Moved "Using iFacialMocap/FaceMotion3D" above "Module" section Updated "Gain and Smoothing" section (previously "Multiplier and Smoothing") - It makes it similar to the iFacialMocap desktop page - It finishes the explanation - Gives tips about who is this for --- .../desktop/iphone/ifacialmocap-iphone.mdx | 57 +++++++++++-------- 1 file changed, 34 insertions(+), 23 deletions(-) diff --git a/docs/hardware/desktop/iphone/ifacialmocap-iphone.mdx b/docs/hardware/desktop/iphone/ifacialmocap-iphone.mdx index fe831234..55962453 100644 --- a/docs/hardware/desktop/iphone/ifacialmocap-iphone.mdx +++ b/docs/hardware/desktop/iphone/ifacialmocap-iphone.mdx @@ -1,10 +1,6 @@ # iFacialMocap (iPhone App) -:::info -Under Construction -::: - -This guide will walk-through setting up the *iFacialMocap* iOS app and the corresponding VRCFT tracking module. +This guide will walk-through setting up the *iFacialMocap* iOS/iPadOS app and the corresponding VRCFT tracking module. ## Setup @@ -12,25 +8,29 @@ This guide will walk-through setting up the *iFacialMocap* iOS app and the corre Ensure that your Apple device is connected to the **same network as your computer**! ::: -1. Install one of the following apps on your Apple device - - The original ($): [iFacialMocap](https://apps.apple.com/us/app/ifacialmocap/id1489470545) - - Free trial version: [iFacialMocapTr](https://apps.apple.com/us/app/ifacialmocaptr/id1520971310) - - "Newer" app ($ - streaming license for "Other/Unity"): [FaceMotion3D](https://apps.apple.com/us/app/facemotion3d/id1507538005) +:::tip +The first time setting this up, your phone should ask if you want to give permission for the iFacialMocap/FaceMotion3D app to access your Local Network. +Make sure to tap "Allow", otherwise the app will be completely blocked from sending data! +::: + +1. Install one of the following apps on your Apple device: + - [iFacialMocap](https://apps.apple.com/us/app/ifacialmocap/id1489470545). + - [iFacialMocapTr](https://apps.apple.com/us/app/ifacialmocaptr/id1520971310) (Free trial version, only use for testing). + - "Newer" app [FaceMotion3D](https://apps.apple.com/us/app/facemotion3d/id1507538005) (Not recommended as it's more expensive with no practical benefit). + 2. Start VRCFaceTracking and install the "**iFacialMocap**" VRCFT module from the [VRCFaceTracking Module Registry](@site/docs/vrcft-software/vrcft.mdx#module-registry). -3. Go to the Output tab in VRCFT and look for the message printing our your computer's *local IP address* - - Verify that the IP address is the local IP of your computer on your local network. See [INSERT LINK HERE] for more general networking tips. + +3. Go to the Output tab in VRCFT and look for the message printing out your computer's *local IP address*. + - Verify that the IP address is the local IP of your computer on your local network. It should start with *192.168.X.X*. + 4. Open the iFacialMocap app on your Apple device, tap the gear in the top right to open settings, then tap the **Destination IP address** option under *Destination setting*. - Enter in the local IP address of your computer as found in step 3 - - If you are using FaceMotion3D, tap the "Live" button in the top left, set the Live Stream type to "Other", and enter in the local IP address of your computer in the provided field -5. The first time setting this up, your phone should ask if you want to give permission for the iFacialMocap/FaceMotion3D app to access your Local Network. - Make sure to tap "Allow", otherwise the app will be completely blocked from sending data! -6. Return to the main iFacialMocap screen. Whenever you are in this screen, the app should be streaming data. - - If you are using FaceMotion3D, simply tap the "Connect" button -7. Verify that the module has initialized in VRCFT + Enter in the local IP address of your computer as found in step 3. + - If you are using FaceMotion3D, tap the "Live" button in the top left, set the Live Stream type to "Other", and enter in the local IP address of your computer in the provided field. -## Module +5. Return to the main iFacialMocap screen. Whenever you are in this screen, the app should be streaming data. + - If you are using FaceMotion3D, simply tap the "Connect" button. -Interested in the source code? Check out the [iFacialMocap module source repository](https://github.com/Shuisho10/VRC_iFacialMocap) +6. Verify that the module has initialized in VRCFT. ## Using iFacialMocap / FaceMotion3D @@ -43,10 +43,21 @@ This is useful to help your avatar look straight forward when you look at the ce 2. While looking forwards towards the center of your monitor (i.e. towards your VRC desktop cursor), tap the "look forward"/Reset button in the app 3. You should see the rotation of the demo face snap to face directly outwards from the screen, indicating that the head orientation has successfully been reset -### Adjusting Multipliers and Smoothing +### Adjusting Weight and Smoothing +:::info +Most people shouldn't need to mess around with these settings, but feel free to tweak them if you think you can improve something or you'd like a blendshape to be easier to trigger. +::: + +iFacialMocap and FaceMotion3D allow you to artificially adjust the tracked values for each blendshape streamed to VRCFT (or other software). Tap the "Settings" gear icon (top right in iFacialMocap, bottom left in FaceMotion3D) and look for the *"Adjust motion weight"* and *"Smoothing motion*" menus. -iFacialMocap and FaceMotion3D allow you to artificially adjust the tracked blendshape values streamed to VRCFT (or other software). -Tap the "Settings" gear icon (top right in iFacialMocap, bottom left in FaceMotion3D) +:::tip +Increase or decrease specific blendshape **Weight** *(how likely it is to trigger a blendshape)* to make a blendshape easier or harder to trigger. +::: +:::tip +Increase the smoothing value to reduce jitter, but increasing this too much will introduce latency, so adjust carefully. +::: +## Module +Interested in the source code? Check out the [iFacialMocap module source repository](https://github.com/Shuisho10/VRC_iFacialMocap)