# Welcome

Welcome to Frostember FaceSync, the ultimate all-in-one facial animation, lip-sync, and procedural head movement system for Unity. Designed for both high-end AAA cutscenes and highly optimized mobile/VR titles, FaceSync bridges the gap between realistic facial expression and zero-CPU runtime performance.

{% hint style="info" %}
WE STRONGLY RECOMMEND TRYING THE DEMO SCENES WHILE READING THE DOCUMENTATION TO BETTER UNDERSTAND THE CONTEXT
{% endhint %}

### Getting Started

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-fire">:fire:</i></h4></td><td><strong>Overview &#x26; Features</strong></td><td><em>Frostember FaceSync provides a unified ecosystem to handle everything above your character's neck</em></td><td><a href="https://3216663219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUhMXol1kUQNRCJY9E1tA%2Fuploads%2F5Bkn98khhq64ekwtYlJ0%2FSocial%20Media%20Image.png?alt=media&#x26;token=0858fc30-df8e-45ad-852f-1a9f802c71be">Social Media Image.png</a></td><td></td><td><a href="getting-started/quickstart">quickstart</a></td></tr><tr><td><h4><i class="fa-leaf">:leaf:</i></h4></td><td><strong>Quick Start (Setup Wizard)</strong></td><td><em>The fastest way to get your character talking is by using our automated Setup Wizard.</em></td><td><a href="https://3216663219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUhMXol1kUQNRCJY9E1tA%2Fuploads%2FGvTU9zVdkIxem9pAiidI%2FSn%C3%ADmek%20obrazovky%202026-03-13%20231524.png?alt=media&#x26;token=30f5d3b6-2bfa-4522-a9d9-776403867499">Snímek obrazovky 2026-03-13 231524.png</a></td><td></td><td><a href="getting-started/publish-your-docs">publish-your-docs</a></td></tr><tr><td><h4><i class="fa-star-exclamation">:star-exclamation:</i></h4></td><td><strong>The Master Component: FaceSync Controller</strong></td><td><em>The <code>FaceSyncController</code> is the "brain" of your character. It unifies all facial features into one clean custom Inspector.</em></td><td><a href="https://3216663219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUhMXol1kUQNRCJY9E1tA%2Fuploads%2F8sIohrMgxNM7rGMxj0WI%2FSn%C3%ADmek%20obrazovky%202026-03-13%20231622.png?alt=media&#x26;token=762fecf5-f11f-4087-9aa1-25c825be7574">Snímek obrazovky 2026-03-13 231622.png</a></td><td></td><td><a href="getting-started/editor">editor</a></td></tr><tr><td><i class="fa-rectangle-video-on-demand">:rectangle-video-on-demand:</i> </td><td><strong>Viseme Mapping &#x26; Profiles</strong></td><td><em>Instead of manually mapping blendshapes for every single character, FaceSync uses <code>VisemeMappingProfile</code> ScriptableObjects. You can share one profile across all characters sharing the same rig (e.g., all MetaHumans, all ReadyPlayerMe avatars).</em></td><td><a href="https://3216663219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUhMXol1kUQNRCJY9E1tA%2Fuploads%2FkAZ5iT8wxoHFNRXMSNs2%2FSn%C3%ADmek%20obrazovky%202026-03-13%20231717.png?alt=media&#x26;token=cc6b2e0f-1002-42ac-ba78-e4f0903fadb6">Snímek obrazovky 2026-03-13 231717.png</a></td><td></td><td><a href="getting-started/markdown">markdown</a></td></tr><tr><td><i class="fa-arrow-down-9-1">:arrow-down-9-1:</i></td><td><strong>API &#x26; Scripting (FaceSync Player)</strong></td><td><em>To trigger dialogue dynamically in-game (e.g., from your Quest System or AI logic), use the <code>FaceSyncPlayer</code> component.</em></td><td><a href="https://3216663219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUhMXol1kUQNRCJY9E1tA%2Fuploads%2F8d7Mfuk2b1FZhS1LGwrV%2FSn%C3%ADmek%20obrazovky%202026-03-13%20232006.png?alt=media&#x26;token=9fedc2aa-9c52-4ef1-9045-6b0b71867216">Snímek obrazovky 2026-03-13 232006.png</a></td><td></td><td><a href="getting-started/images-and-media">images-and-media</a></td></tr><tr><td><i class="fa-map-location">:map-location:</i></td><td><strong>Roadmap</strong></td><td><em>Project Roadmap</em></td><td><a href="https://images.unsplash.com/photo-1531403009284-440f080d1e12?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHw1fHxyb2FkbWFwfGVufDB8fHx8MTc3MzU3NjY0Nnww&#x26;ixlib=rb-4.1.0&#x26;q=85">https://images.unsplash.com/photo-1531403009284-440f080d1e12?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHw1fHxyb2FkbWFwfGVufDB8fHx8MTc3MzU3NjY0Nnww&#x26;ixlib=rb-4.1.0&#x26;q=85</a></td><td></td><td><a href="roadmap">roadmap</a></td></tr></tbody></table>

### Workflows

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-1">:1:</i></h4></td><td><strong>Workflow A: Offline Baking (Zero-CPU Performance)</strong></td><td><em>For mobile and VR games, analyzing audio in real-time is too expensive. Our Baker allows you to pre-compute everything.</em></td><td><a href="https://images.unsplash.com/photo-1682068548081-50aa8b92c8c1?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHw0fHxDUFV8ZW58MHx8fHwxNzczNDQwNDkxfDA&#x26;ixlib=rb-4.1.0&#x26;q=85">https://images.unsplash.com/photo-1682068548081-50aa8b92c8c1?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHw0fHxDUFV8ZW58MHx8fHwxNzczNDQwNDkxfDA&#x26;ixlib=rb-4.1.0&#x26;q=85</a></td><td></td><td><a href="workflows/workflow-a-offline-baking-zero-cpu-performance">workflow-a-offline-baking-zero-cpu-performance</a></td></tr><tr><td><h4><i class="fa-2">:2:</i></h4></td><td><strong>Workflow B: Unity Timeline Integration</strong></td><td><em>FaceSync comes with a custom, native Unity Timeline integration designed for AAA cutscenes.</em></td><td><a href="https://images.unsplash.com/photo-1603516875773-9a4c1861d5ed?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHwyfHxUaW1lbGluZXxlbnwwfHx8fDE3NzM0NDA1MTB8MA&#x26;ixlib=rb-4.1.0&#x26;q=85">https://images.unsplash.com/photo-1603516875773-9a4c1861d5ed?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHwyfHxUaW1lbGluZXxlbnwwfHx8fDE3NzM0NDA1MTB8MA&#x26;ixlib=rb-4.1.0&#x26;q=85</a></td><td></td><td><a href="workflows/workflow-b-unity-timeline-integration">workflow-b-unity-timeline-integration</a></td></tr><tr><td><h4><i class="fa-3">:3:</i></h4></td><td><strong>Workflow C: Live Microphone (VTubing/Multiplayer)</strong></td><td><em>If you are building a VTubing app or a multiplayer game with voice chat</em></td><td><a href="https://images.unsplash.com/photo-1521424159246-e4a66f267e4b?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHwzfHxNaWNyb3Bob25lfGVufDB8fHx8MTc3MzQ0MDUzN3ww&#x26;ixlib=rb-4.1.0&#x26;q=85">https://images.unsplash.com/photo-1521424159246-e4a66f267e4b?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHwzfHxNaWNyb3Bob25lfGVufDB8fHx8MTc3MzQ0MDUzN3ww&#x26;ixlib=rb-4.1.0&#x26;q=85</a></td><td></td><td><a href="getting-started/publish-your-docs">publish-your-docs</a></td></tr></tbody></table>

### Additionals

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-face-sad-tear">:face-sad-tear:</i></h4></td><td><strong>Emotions</strong></td><td><em>Facial emotions Integration.</em></td><td><a href="https://images.unsplash.com/photo-1652514846497-85b7d6acefc9?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHwxfHxlbW90aW9uc3xlbnwwfHx8fDE3NzcwNDE3MzJ8MA&#x26;ixlib=rb-4.1.0&#x26;q=85">https://images.unsplash.com/photo-1652514846497-85b7d6acefc9?crop=entropy&#x26;cs=srgb&#x26;fm=jpg&#x26;ixid=M3wxOTcwMjR8MHwxfHNlYXJjaHwxfHxlbW90aW9uc3xlbnwwfHx8fDE3NzcwNDE3MzJ8MA&#x26;ixlib=rb-4.1.0&#x26;q=85</a></td><td></td><td><a href="additionals/emotions">emotions</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://frostember-studios.gitbook.io/face-sync/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.