# v1.6.4 Release Notes

Release Date: June 12, 2025

### Sample Files Included for Default Demostrations

* The following files are copied to `{User}/YanusLIVE/demo` upon installation.

<figure><img src="/files/aSmH7DZZTWV0zkY1SlKZ" alt=""><figcaption></figcaption></figure>

* Sample Files

  * Unity Character package
  * ejpark (Fast facial movements, 19 seconds)
  * yang (Rapid speech, 3 seconds)

  Includes Videos, ActorProfile, and Facial Data CSV File

* Press Two Buttons to Start the Default Demo in YanusLIVE

<figure><img src="/files/KUPShH5991G1EcGt93yO" alt="" width="563"><figcaption></figcaption></figure>

1. Character Window > Start Button
   1. A security permission prompt may appear on first launch.
2. Actor Window > Start/Pause Button
   1. While playing, a pause icon is displayed.
   2. You can adjust the slider while in pause mode.

* Automatically Configured with Sample Files on First Launch

<figure><img src="/files/bMZhnrAedfOqMrgEfIYL" alt="" width="563"><figcaption></figcaption></figure>

1. Device Selection : `OBS Studio`
   1. Default Setting Changed in HyperDeck
2. Local Folder Path :  `{User}/YanusLIVE/demo`
3. Actor mode :  `Video File`
4. File Path :  `User}/YanusLIVE/demo/demo_video_ejpark.mp4`
5. Rotate Left 90 Degrees : `On`
6. View Facemesh : `On`

<figure><img src="/files/F0zvvIYhoVt4T8DNwg6D" alt="" width="347"><figcaption></figcaption></figure>

7. Menu > View, Live Information : `Checked`
8. Character mode : `Vroid`
   1. Settings > Character, Character 1

<figure><img src="/files/WGFqioIHUxi0lPtr0h3P" alt="" width="563"><figcaption></figcaption></figure>

9. Actor Profile :  `User}/YanusLIVE/demo/actor_profile_ejpark.json`

<figure><img src="/files/KUWa9xRM7ez8IOfrFWEx" alt="" width="375"><figcaption></figcaption></figure>

### CSV Playback via Double-Click from the Local File List

<figure><img src="/files/l0ROhegdy8JLw95rdYop" alt="" width="563"><figcaption></figcaption></figure>

1. Double-clicking a CSV file plays the matching video in `Video File Mode with CSV Data File`.
   1. CSV files with additional tags in the filename are also matched with the corresponding video files automatically.
   2. Double-clicking the video file again plays it in the default Video File Mode.

2. When playing a CSV file, the Actor screen is outlined in green for distinction.
   1. View Facemesh is automatically disabled.
   2. Neutral Calibration values and retargeting by Actor Profile are not applied.

<figure><img src="/files/VCWzOGkQcl2Hr0bi86pn" alt="" width="563"><figcaption></figcaption></figure>

3. This feature automates the manual **CSV Data File Play** setting found in **Settings > Experimental**.
   1. If the video file and CSV file are not in the same directory or their names do not match, this setting can be used.
   2. Note that changes to the parameters in **Settings** take effect only after clicking **Apply**.
   3. When playing a video not by double-clicking in the **Local File List**, but from the **Actor window** or by using the **play/pause buttons**, the system checks the frame count of both the video and CSV file if they do not match, a warning is displayed and playback is aborted.

### Automatic Scaling Option for Neutral Calibration

The following highlights the updates in Settings > Experimental.

<figure><img src="/files/WGScKsMSpAlkyOuArE8W" alt="" width="563"><figcaption></figcaption></figure>

1. Added a new "**Neutral Calibration**" subsection
   1. "**Auto Scale Adjustment in Neutral Calibration**"
      1. This feature adjusts the scale range using the formula `1 / (1 - neutral_value)` when the neutral value is greater than 0.5, and automatically sets the scale to half of that range.
      2. In previous versions, this was always applied in order to compensate for the issue where changes in the corresponding blendShape appeared too subtle.
      3. To prevent the side effect of noise amplification, the default setting is disabled upon installation.
   2. "**Apply Eye Direction Neutral Value During Retarge**t"
      1. This option is not applied during Neutral Calibration.
      2. When performing Neutral Calibration using a recorded video, it is recommended to disable this option if there are no front-facing frames.
2. The "**Font Size**" section has been moved downward.
3. The option previously under "**Sync Eye Movement**"
   1. "Enable Neutral Cal. Eye Direction" has been renamed and moved to the new "Neutral Calibration" subsection.

### Persistent user Preferences for 'View Facemesh' and 'Live Information'

In previous versions, the settings for these two view options were not saved upon program exit. This has been implemented in the current version.


---

# 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://docs.yanusstudio.com/yanuslive/notices-and-resources/v1.6.4-release-notes.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.