> For the complete documentation index, see [llms.txt](https://docs.yanusstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yanusstudio.com/yanuslive-pro/function-guide/real-time-face-tracking.md).

# Real-Time Face Tracking

Real-time face tracking is the core function of YanusLIVE Pro.

The application detects the face, estimates landmarks, tracks head pose, and converts motion into animation-friendly data.

### Good tracking conditions

* Keep the face clearly visible.
* Use stable lighting.
* Keep the camera steady.
* Avoid heavy occlusion.
* Stay within the expected tracking distance.

### Common tracking issues

| Issue                | Possible cause                                            |
| -------------------- | --------------------------------------------------------- |
| Face not detected    | Camera inactive, face outside the frame, or poor lighting |
| Jittery motion       | Low light, camera noise, or low smoothing                 |
| Delayed response     | Too much smoothing                                        |
| Incorrect expression | Camera angle, occlusion, or poor calibration              |
| Tracking reset       | Face lost or confidence too low                           |

### Best practice

Always confirm tracking quality visually before recording or streaming.
