
  VMD Checker for VRM Live Viewer    V1.21  
                               Copyright(c) F.Issiki 2023, 2025  

   This is VMD Checker English edition for VRM Live Viewer 
for Win32 compatible environment. 

   This tool is for checking bone/morphing data recorded in a 
VMD file.
   The unsupported bone names in VRM Live Viewer will be 
displayed in red-to-orange colors. 
　　


<< How to use >> 

- Drag and drop a VMD file that you want to check  
  onto VmdChecker-VRM.exe. 

  This tool displays the lists of bone names and morphing names 
  recorded in the VMD. 

- Press [x] (close) button, [ESC] key, or [Q] key to quit. 

- You can also open a VMD file by executing VmdChecker-VRM.exe 
  by double-clicking and then selecting the VMD file 
  on the dialog. 

- You can drag and drop another VMD file onto the window 
  that is showing the lists of bone and morphing names. 

- A screenshot of the window can be saved with [S] key. 
  The screenshot files will be saved within the folder 
  that has VmdChecker-VRM.exe as cap(xx).bmp, 
  where the xx will be numbers (1, 2, ...). 
  


<< Results of the check >> 

  This tool displays the lists of the names of the used bones 
in seven colors depending on the rotation and the translation 
recorded in the bone data. 

  1. "Red" -- showing that the bone is unsupported in VRM Live 
              Viewer, and may be causing license violation 
              with a high probability (>90%) due to the lack 
              of the motion of this bone.  
              
              We reccommend conversion or manual editting 
              of this VMD file. 
              In most cases, the motion of this bone will 
              be integrated into other bones using conversion 
              tools. 

  2. "Red orange" 
           -- showing that the bone is unsupported in VRM Live 
              Viewer, and may be causing license violation 
              normally (>60%) due to lack of motion of this 
              bone.  
              
              Check the ReadMe attached with the VMD file. 
              If this bone is assigned as a "necessary" bone 
              in the ReadMe, the movie using the VMD will be 
              prohibited from public uploading. 

  3. "Orange" 
           -- showing that the bone is unsupported in VRM Live 
              Viewer and often (>30%) causing license 
              violation due to lack of motion of this bone, 
              but in many cases the problem can be solved 
              using conversion tools. 
              
              We recommend using conversion tools for this   
              VMD file. 
              Manual editing using MMD will also be another 
              solution. 

  4. "Yellow" 
           -- showing that the bone has motion often 
              causing a collapsed display of the model surface 
              or misalignment in VRM models. 
              
              Yellow bones sometimes (10-20%) cause license 
              violation due to the requirement for manual 
              fixing or adjustment, depending on the 
              license in the ReadMe of the VMD.  
 
              We recommend trying conversion tools for this   
              VMD file. 
              If yellow bones remain in the converted VMDs, 
              the bone may have abnormal motion in some 
              frames. 
              (VMDTMS will often show the hints for it.) 

  5. "Light yellow" 
           -- showing that the bone has the motion that may 
              lead to a collapsed display of the model surface 
              or relatively small misalignment of the bone 
              position in VRM models. 
              
              We recommend trying conversion tools for this   
              VMD file, if the VMD file has not been converted 
              yet. 
              
  6. "Gray" 
           -- showing that the bone will be ignored in the 
              VRM Live Viewer due to the lack of compatible 
              bones with PMXs. 
              
              Although the bone will be ignored in VRMs, 
              in most cases, the VMDs will be allowed for the 
              use without the gray bones. 

  7. "White" 
           -- showing that the bones have no problem 
              in VRM live Viewer in the normal cases. 
  
  Please note that the above classification is for helping 
user judgment and for showing the possibilities for the risks. 
  The MMD bone systems often change with time, as all the 
users are allowed to create new bones and distribute the VMDs 
for them.  The license of the VMDs, moreover, can be defined 
by users as like and may change in various ways. 
  
  This tool omits to display the bone names and/or morphing 
names in the lists, if all the bone keys or morphing keys of 
the same name are inactive (i.e., all XYZ=0/R=0 for bones or 
all V=0 for morphing). 



<< For advanced users >> 

- The file "alias.ini" defines the replacement of letters or 
  characters in bone names and/or morphing names. 
  If you delete "alias.ini" or rename it to some other name
  (e.g., to "alias-bak.ini", etc.), 
  this tool displays bone names or morphing names in their 
  native names as recorded in the VMDs. 
  
- The definition in "alias.ini" is not perfect (as they have 
  >100000 varieties), and this tool may miss in replacing 
  bone names or morphing names to English names. 
  
  You can edit and add definitions into "alias.ini" using text 
  editors. 
  We would be glad if you feedback about the alias.ini file. 
  
- You can also download the Japanese edition and use it at 
  the same time with this English edition on the same PC.  



<< Supported OS versions >> 

  OS: Windows 8, 8.1, 10, and 11  (x32, x64) 
 　　　(also available on Windows 10/11 in UTF-8 mode)
  RAM: 40 MB or more  (not Giga) 

- This tool does not require Japanese language environment. 
   (This tool emulates Jananese language processing in 
    oversea environment.) 

- This tool set is a Windows-95-compatible software. 
  By default, the OS launches this tool in ANSI-compatible 
  mode (famous as DBCS or SHIFT-JIS, etc.). 
  This tool also supports UTF-16 and UTF-8 modes detecting the OS 
  support. 
  
  If you encountered an error executing this tool, please 
  remove Unicode-specific characters in file/folder names, or 
  move all tool files directly onto the Desktop.
  
  You can also use this tool in UTF-8 console mode if you encountered 
  with the character code problems. 
  
  The UTF-8 mode can be enabled using "UTF-8 for worldwide 
  language support", which can be enabled in Region Settings 
  in the Settings menu on Windows 10/11. 

- Norton Sonar (by NortonLifeLook Inc.(formerly Symantec)) 
  has been found to detect .exe files of this software as an "unknown 
  executable file" and automatically delete them, even if the executable 
  files are free from viruses (not infected). 
  In that case, check and re-scan the executable file (VmdChecker-VRM.exe)  
  again with the manual scan in the Norton. If the result of the 
  re-scan shows "no infection" and clarified it to be clean from viruses, 
  please "Recover" and "Exclude" the VmdChecker-VRM.exe from the scan 
  in the "Process" menu in the Norton. 

- This tool directly reads the font file (mplus-2m-regular.ttf) to 
  support Japanese character codes natively recorded in VMD files. 
  Some anti-virus scanners may react to the font file reading, 
  since the font files are usually read-only from OS systems and not 
  by applications. 
  Please retry executing the tool or set the settings of the virus 
  scanners in those cases. 
  


<< Copyrights and conditions for use (legal notice) >> 

  The author (F.Issiki) holds overall copyrights of this tool. 
  This tool is freeware.  
  This software is provided 'as-is', without any express or implied 
  warranty.  In no event will the authors be held liable for any damage 
  arising from the use of this software or inability to use the program. 
  


<< VMD Checker Version history >> 

 V0.40   Beta test ver. 1. 
 V0.50   Beta test ver. 2. 
 V0.52   Beta test ver. 3. 
         Auto-numbering of screenshot files (cap(num).bmp) supported. 
 V0.56   Bug fix: Rotation angles were displayed as "NaN" in some VMDs. 
         => Fixed. 
 V1.01   First released version.  
 V1.02   Changed to release (unlock) the VMD file just after the scanning. 
         Revised alias.ini.  
 V1.04   Supported the native name display of the "regret" morphing. 
         Some definitions in the alias.ini appended.  
 V1.05   UpperBody3 warning supported.  
         Some unsupported bones registered.  
 V1.06   All the morph names are changed to be displayed on the list 
         even if the morph names are not of Animasa Miku Ver.2 standard. 
         Bug fix: unused morph names in which all morph key values are 
                  set to zero had been displayed in mistake 
                  for the morphs unsupported Animasa Miku Ver.2. 
         => Fixed so that the unused morph names are excluded from the 
            display. 
         Some unsupported bones registered.  
         Some definitions in the alias.ini appended.  
 V1.07   LeftEye, RightEye, BothEyes are changed to be judged as normal 
         bones instead of the previous "ignored (gray)" bones, reflecting 
         the changes in VRM Live Viewer v3.9.    
         Some definitions in the alias.ini appended.  
 V1.08   UTF-16 path/file name recognition improved. 
         LeftToeEX, RightToeEX warning supported.  
 V1.09   Bug fix in calculatiing twist rotation angle. 
 V1.10   Updated UpperBody3 judgement reflecting VMDTMS V1.21c update.  
 V1.11   Supported the native name display of the "discontent" morphing. 
         Some unsupported bones registered.  
         Windows code signing supported. 
 V1.12   Bug fix: VmdChecker failed in starting in the folders that have 
         UTF-specific letters in the folder names. 
         => Fixed. 
 V1.14   LowerBody warning was revised so that the VMDs with relatively 
         small LowerBody rotation angles are classified as white and/or 
         light yellow warning levels. 
 V1.15   ToeEX warning was changed to be judged as "white," and 
         LegIKP warning was revised to be judged as "light yellow" or 
         "white" depending on its rotation angles, 
         reflecting the changes in VRM Live Viewer v3.10.  
 V1.16   LegIKP warning was revised to be judged into 3 levels as 
         "yellow," "light yellow," or "white" depending on its rotation 
         angles. 
 V1.17   Improved to display finger bones with non-zero xyz-position 
         offset.   
         Improved to process the VMD files that have [~] (tilde/swung 
         dash) symbols in the file/folder names. 
         Updated Japanese-English translation table (alias.ini). 
 V1.18   Supported "LeftToe", "RightToe", and "GazeIK" bones for the 
         standard bone display. 
 V1.20   Bug fix: non-standard bone names disappeared when PMX dropped 
                  after the VMD. => Fixed. 
         Updated Japanese-English translation table (alias.ini). 
 V1.21   Supported "CenterP*" and "CenterAux*" bones classified as 
         orange warning levels. 


<< Acknowledgements >> 

  We gratefully acknowledge VMD file information by Harigane-P. 
  
  This software is based in part on the work of the FreeType Team. 
  This helps display TrueType fonts in this tool. 
  
  We use M+Font (TESTFLIGHT-063 ver.) (mplus-2m-regular.ttf) in this set. 
      -- 
      M+ FONTS                          Copyright (C) 2002-2017 M+ FONTS PROJECT
      These fonts are free software.
      Unlimited permission is granted to use, copy, and distribute them, with
      or without modification, either commercially or noncommercially.
      THESE FONTS ARE PROVIDED "AS IS" WITHOUT WARRANTY.
      -- 
      http://mplus-fonts.osdn.jp
  We would like to thank COJI MORISHITA and the members of M+ FONTS PROJECT. 
  
  "Hatsune Miku" is the name of a vocal character by Crypton Future Media 
  Inc., Japan. 
  
  The author would like to thank all the artists of those tools, models, 
  music, and movies related to Miku Miku Dance. 


Dec 30, 2025 
F.Issiki 
Finekit, Artist Support 
https://finekit.co.jp/base/
