Skip to main content

How to Use the Tool

Usage​

Run CriLipsMake2 on the command line and input an audio file.
A text file containing animation curve information for lip sync will be generated.

Command Arguments​

If you run CriLipsMake2.exe with -h specified, the following Simple Help will be displayed.

> CriLipsMake2.exe -h
|||||||||||| CriLipsMake2 Ver.X.YY.ZZ ||||||||||||
Copyright (c) 2025 CRI Middleware Co., Ltd.
usage: -in=sample.wav

[Required]
-in=<VALUE>                      :<Input File(.wav)>
 -i <VALUE>                      :Same as -in

[Optional]
-out=<VALUE>                     :[Output File(.csv)] (Default: Same directory and basename as input file)
 -o <VALUE>                      :Same as -out
-smooth_mode=<VALUE>             :Set the smoothing level for the output animation. (Default: {normal} )
 -m <VALUE>                      :Same as -smooth_mode
-volthreshold=<VALUE>            :Volume threshold that is treated as silence. [-96 - 0] (Default: -40)
 -vol <VALUE>                    :Same as -volthreshold
-enable_adxlip_compat            :Enable output of .adxlip file (aiueo-based morph target blend format) for CriLipsMake.exe compatibility.        
 -adxlip                         :Same as -enable_adxlip_compat
-enable_lab_phoneme              :Enable output of .lab file (timing-based audio segment).
 -lab                            :Same as -enable_lab_phoneme
-use_external_device             :Use external device for inference.
 -e                              :Same as -use_external_device
-behaviour_params=<VALUE>        :<Input Behaviour Params File(.json)>
 -params <VALUE>                 :Same as -behaviour_params
-enable_auto_detection_mouth_open:[Experimental]Automatically detect the mouth opening size from the intonation of the voice.
 -a                              :Same as -enable_auto_detection_mouth_open
-verbose                         :Print verbose logs.
 -v                              :Same as -verbose

Command Example 1​

> CriLipsMake2.exe -in=sample.wav -out=sample.csv
  • -in
    • Specify the wav file to be analyzed
  • -out
    • Specify the path string to output the analysis result file
    • The output file will be forcibly overwritten, so be careful not to overwrite any important files with the same name

Command Example 2​

This is a command example using short arguments.
For short arguments, connect <VALUE> with a space instead of =.

> CriLipsMake2.exe -i sample.wav -o sample.csv

Command Example 3​

Enable .adxlip file compatible output and specify the smoothing level.

> CriLipsMake2.exe -in=sample.wav -out=sample.csv -smooth_mode=quick -enable_adxlip_compat
  • -smooth_mode=quick
    • Specifies quick as the smoothing level to generate lip sync animation
    • Character models that were morphing with adxlip files will have a similar animation feel when quick is specified

For details on smoothing, please check the following:

Command Example 4​

Enable the beta feature under development that estimates mouth opening from speech intonation.

> CriLipsMake2.exe -in=sample.wav -out=sample.csv -enable_auto_detection_mouth_open

The quality of the analysis result is not guaranteed. Also, specifications and behavior may change in future updates.
Please use this feature with the understanding that it is a beta feature.

This feature estimates mouth opening in three levels: large, medium, and small. You can change the specific mouth opening size from the following options: