Add Simplified Chinese (zh-Hans) localization

[ygud]

Description

This PR adds comprehensive Simplified Chinese () localization to VCam, covering all UI components, tracking settings, shortcut actions, and VRoidHub integration.

Changes

• Added localizations to
• Added localizations to

Thank you for developing this great open-source project! 🚀

[tattn]

Thanks for the PR! Given the VTuber community, I’ve been hoping to support Chinese next.

Since I can’t read Chinese myself, I reviewed the translations with the help of AI and found a few potential issues:

1. Missing Simplified Chinese translations
   It looks like there are still quite a few strings that haven’t been translated. I’d prefer to avoid partial localization because mixing English and Chinese tends to result in a poor UX, so ideally I’d like the Chinese localization to be complete.
   Are you planning to split the localization work across multiple PRs, or is this PR intended to complete the Chinese localization?

2. pick
pick is translated as 吸管取色, which seems to mean picking a color with an eyedropper. This string is used for selecting a file, so 选择 or 选择文件 may be more appropriate.

3. bye
bye is translated as 挥手打招呼, which seems to mean waving to greet someone. Since this is the “Bye” motion, 挥手告别 may be more appropriate.

4. settings
settings is translated as 系统设置, which seems to specifically refer to system settings. This key is also used for app-specific settings, such as motion settings, so 设置 may be more appropriate.

How did you approach the translations? Were they translated manually, with translation tools/AI, or a combination of both? Since I can’t evaluate the nuances of Chinese myself, I’d also appreciate your thoughts on the overall translation accuracy and whether there are any areas that may still need review.

[ygud]

Hi @tattn, thank you so much for the detailed and thoughtful review!

👤 Background & Approach

To give a bit of context: I was searching for a native, open-source 3D avatar/VTuber solution on macOS and found VCam, which has been fantastic to use!

I don't have a heavy programming background, but since I really wanted Chinese support for daily use, I used Google Gemini to assist with translating the strings, and then tested and refined the terminology during my own hands-on use. After using the localized version myself and finding that it worked great, I wanted to share it back via this PR so more Chinese-speaking Mac users can benefit from your work.

---

🚀 Updates in this PR

I have just pushed a new commit (f50c931) to address all your feedback:

1. 100% Localization Coverage (0 Missing Strings):

   • Completed all missing strings across both VCamUI (353/353) and VCamVRoidHub (34/34). There are now 0 untranslated keys in the entire project. This PR is intended to provide a complete, ready-to-merge Chinese localization without mixed languages.

2. Applied Your Specific Corrections:

   • pick -> 选择文件 (Select file)
   • bye -> 挥手告别 (Wave goodbye)
   • settings -> 设置 (Settings)

3. Terminology & Nuances:

   • Polished the terminology against standard macOS Chinese UI conventions and VTuber/VRM community norms (e.g., standard terms for BlendShapes, VRMA conversion, and facial/hand tracking).

Please feel free to take another look whenever convenient. Thank you again for creating such a wonderful project for the macOS VTuber community! 🚀

[tattn]

@ygud
Thanks for the updates! I found a few more areas that may be worth improving:

1. Head Rotation X/Y/Z
   The Chinese translations add specific meanings such as left/right rotation and head tilt, but they do not seem to match the actual axis definitions. It may be safer to keep them generic, such as 头部旋转 X, 头部旋转 Y, and 头部旋转 Z.

2. VRoid Hub usage conditions
   Some translations add meanings that are not present in the original text, such as R-18, R-18G, or wording that implies permission. These labels are based on VRoid Hub's official usage-condition definitions, so I would prefer to keep them as close to the original meaning as possible.
   This part is related to how VCam presents the VRoid Hub license information, so I’ll handle these translations/labels on my side.

3. Edit Output Bounds
   调整输出画面边界 sounds like adjusting the boundaries of the screen/image, but this setting edits the minimum and maximum values of the tracking output range. Something closer to 编辑输出范围 may be better.

4. Blur
   背景模糊 means “background blur,” but this is a general blur filter and is not limited to the background. A more generic translation such as 模糊 may be better.

5. Chroma Keying
   色度键抠绿 seems to imply green-screen removal, but VCam can remove any selected color. It may be better to use a more general term such as 色度键.

6. Not Supported
   当前设备不受支持 implies that the current device is unsupported, but this text can also be shown when a feature is unavailable in the current app/build. A more generic 不支持 may be better.

7. Motion
   预设动作 means “preset motion,” but this window also contains custom .vrma motions. A more generic 动作 may fit better.

I suspect Gemini may be translating mainly from the key name and may not always have enough context about how each string is actually used. If possible, it would be helpful to provide the English, Japanese, and Korean translations together to Gemini and ask it to create the most appropriate Chinese translation based on all of them.

Alternatively, if you are comfortable reviewing the Chinese yourself, I would really appreciate it if you could also check the UI again and confirm that the wording feels natural and appropriate for typical Chinese software interfaces.

There may still be some issues that I haven’t caught in the review above.

I definitely want to include this Chinese localization, and I really appreciate your work on it 😄

[ygud]

Hi @tattn, thank you again for pointing those out!

You're completely right — previously I was only thinking about making things "easy to understand" for casual users (like adding "green screen" or specific directions), but ended up over-interpreting terms and sacrificing the precision and generality needed for software UI.

This time, with the assistance of Google Gemini and my own hands-on review through the running app screen by screen (including the model accessory editing view, which is super neat!), we reviewed the terminology in actual UI context across English, Japanese, and Korean to make them clean, precise, and standard:

1. Applied All Specific Corrections:

   • Head Rotation X/Y/Z: 头部绕X轴旋转, 头部绕Y轴旋转, 头部绕Z轴旋转 (using precise 3D kinematic rotation phrasing)
   • Blur: 画面模糊 / 模糊
   • Chroma Keying: 色度键 (Chroma Key)
   • Not Supported: 不支持
   • Motion: 动作
   • Smoothing / Tracking Smoothing: 平滑处理 / 追踪平滑度
   • Soft Knee (Bloom): 泛光柔和度 (Soft Knee) (accurately reflecting the bloom optical knee instead of anatomy)
   • Other terms like 支持语言, 优化模型网格, 肩部旋转权重, 风效, 暗角效果, 色调偏移 have all been cleaned up and standardized.

2. Note on editOutputBounds:

   • Since the Tracking Mapping Editor window doesn't seem to have a visible entry point in the main settings UI yet, I wasn't 100% certain about its exact runtime presentation, so I changed it to the generic 编辑输出范围 (Edit Output Range). Please feel free to adjust it if you have a preferred phrasing!

3. VRoid Hub License Terms:

   • Totally agree with your suggestion! Since VRoid Hub has strict official licensing guidelines, leaving that part for you to align on your side is definitely the best approach.

I've tested the whole app locally with these changes and the wording feels much more natural, cohesive, and professional now. Please let me know if there are any other areas you'd like to tweak! 🚀

[tattn]

Thank you for translating the text into Chinese and for addressing the items raised in the review.

After checking the fork associated with the PR, modifications and redistribution of the VCam distributed binaries were found, which violates the VCam Terms of Use.

Please remove the following release:
https://github.com/ygud/app/releases/tag/v0.15.1-zh

In addition, it is difficult to accept a PR from a repository that is in violation of the Terms of Use, so this PR will be rejected.

Support for Chinese is something worth pursuing, and it will be considered in the future.