[Community Localization] Working Simplified Chinese frontend prototype for Portmaster v2.2.1

[dutao6678]

Simplified Chinese frontend localization prototype for Portmaster

Hello Portmaster maintainers and community,

I have created a working Simplified Chinese frontend localization prototype based on Portmaster v2.2.1.

The localized frontend has been successfully compiled and tested on Windows. It loads correctly after replacing the original frontend resource package, portmaster.zip.

This is an unofficial community localization prototype, not an official Portmaster release.

Current localization scope

The first-stage version mainly translates the Angular frontend, including:

• Main navigation and tooltips
• Application list and application details
• Network Activity page
• Connection filters, sorting and grouping controls
• Connection details and common status labels
• Help and Support pages
• SPN introduction and onboarding pages
• Common dialogs, buttons and menu items
• Relative-time labels
• Part of the dashboard and notification interface
• Simplified Chinese font fallback and layout adjustments

The tested pages load without visible encoding errors or major layout problems.

What was not modified

This localization does not modify:

• portmaster-core.exe
• portmaster-kext.sys
• Windows network filtering drivers
• Firewall behavior
• DNS filtering logic
• SPN routing logic
• Network rules or security decisions

The current changes are mainly limited to:

desktop/angular/

The goal of this first stage was to localize the user interface without changing Portmaster's networking and security core.

Known limitations

Some interface text is still displayed in English because it is dynamically provided by the Portmaster core or desktop shell.

Examples include:

• Global setting names and descriptions
• Some application setting names
• Core-generated notifications and error messages
• Tray menu items
• Some dynamic connection labels
• Some country and network status names
• A few remaining frontend strings

Therefore, this is currently a frontend localization prototype, rather than a complete multilingual implementation.

Build result

The localized frontend was successfully built with the existing Portmaster Angular build process.

The generated resource package was produced at:

packaging/windows/dev_helpers/dist/portmaster.zip

The compiled package has been tested on Windows with Portmaster v2.2.1 and is working correctly.

Files attached

The following files are attached for testing, review and collaboration:

• Portmaster-2.2.1-zh-CN-stage1.patch
  Git patch containing the localization changes.

• Portmaster-2.2.1-zh-CN-stage1-patch.zip
  Source patch and localization documentation.

• Portmaster-zh-CN-v2.2.1-stage1-test.zip
  Test package containing:

  • portmaster.zip
  • README-zh-CN.txt
  • SHA256.txt

The compiled package is provided only for testing. Developers can review the patch and build the frontend independently.

Screenshots

The screenshots below show the current Simplified Chinese interface running on Windows.

Portmaster-2.2.1-zh-CN-stage1.patch
Portmaster-2.2.1-zh-CN-stage1-patch.zip
Portmaster-zh-CN-v2.2.1-stage1-test.zip

Installation for testing

Important: This test package is intended for Portmaster v2.2.1. Back up the original file before testing.

1. Completely shut down Portmaster.

2. Extract Portmaster-zh-CN-v2.2.1-stage1-test.zip.

3. Back up the original file:

   C:\Program Files\Portmaster\portmaster.zip
   

4. Copy the extracted localized portmaster.zip into the Portmaster installation directory and replace the original file.

5. Restart Portmaster.

To restore the official English interface, completely shut down Portmaster and restore the original portmaster.zip backup.

Goals of this issue

I am publishing this prototype to:

1. Ask whether the maintainers are interested in official Simplified Chinese support.
2. Collect feedback on translation quality and terminology.
3. Invite Chinese-speaking developers and translators to participate.
4. Identify remaining frontend strings and layout issues.
5. Discuss whether Portmaster plans to introduce a reusable i18n architecture.
6. Understand the preferred structure for a future pull request.

I understand that directly replacing English strings is not the ideal long-term architecture.

If the maintainers are interested, I would be happy to help reorganize this work into a proper localization system, for example:

en.json
zh-CN.json

with language selection, persistence, fallback behavior and reusable translation keys.

Disclaimer

This is an unofficial community localization project.

It is not affiliated with, endorsed by, sponsored by or maintained by the official Portmaster project or its maintainers.

Portmaster and related names and logos belong to their respective owners.

Thank you for developing Portmaster. It is an excellent and powerful application, and I hope this localization work can make it more accessible to Chinese-speaking users.

---

中文说明

这是一个基于 Portmaster v2.2.1 制作的非官方简体中文前端汉化原型。

目前中文版已经在 Windows 上成功编译并完成实际运行测试。导航栏、网络活动、应用详情、帮助页面、SPN 页面、常用按钮、筛选菜单和部分提示内容已经完成汉化。

本次修改主要位于：

desktop/angular/

本次汉化没有修改：

• 网络过滤驱动
• 防火墙核心
• DNS 过滤逻辑
• SPN 路由逻辑
• Portmaster 的网络规则和安全判断

目前仍有部分英文来自 portmaster-core.exe 或桌面外壳动态提供，例如全局设置名称、部分通知、托盘菜单和动态状态文字。

发布这个 Issue 的目的，是展示当前成果、征求官方意见，并邀请开发者和翻译者共同参与后续完善。

希望未来能够在官方建议下，将当前原型进一步改造成正规的 i18n 多语言架构，而不是长期采用硬编码中文的方式。

[github-actions]

Greetings and welcome to our community! As this is the first issue you opened here, we wanted to share some useful infos with you:

• 🗣️ Our community on Discord is super helpful and active. We also have an AI-enabled support bot that knows Portmaster well and can give you immediate help.
• 📖 The Wiki answers all common questions and has many important details. If you can't find an answer there, let us know, so we can add anything that's missing.

[dutao6678]

So far, I have not found any functional problems caused by the localization.
The remaining untranslated settings appear to be provided dynamically by the
Portmaster core.

Could a maintainer please advise whether a proper i18n pull request would be
welcome, and which architecture or branch would be preferred?

Thank you.

[dutao6678]

Simplified Chinese localization update — Stage 1.1

I have completed and tested an updated Stage 1.1 version of the Simplified Chinese frontend localization, still based on Portmaster v2.2.1.

This update expands the frontend translation coverage and improves several remaining interface texts, including:

• Network Activity results, pagination and filter labels
• Incoming and outgoing connection labels
• Connection scope and status descriptions
• Import and export dialogs
• Common confirmation, success and error messages
• Additional settings-page frontend labels
• SPN status, country and node descriptions
• Application and global-settings interface text
• Tooltips, buttons and other remaining frontend strings

The changes remain primarily limited to:

desktop/angular/

The localized frontend resource package is generated by the existing build process at:

packaging/windows/dev_helpers/dist/portmaster.zip

This update does not modify Portmaster's networking or security behavior, including:

• portmaster-core.exe
• Windows network filtering drivers
• Firewall decisions
• DNS filtering logic
• SPN routing logic
• Network rules

The updated frontend has been compiled successfully and tested on Windows in normal daily use. So far, I have not found any functional problems caused by the localization.

Some English text still remains because it appears to be supplied dynamically by the Portmaster core or desktop shell, such as certain setting names, descriptions, notifications and tray-menu items.

Attachment

portmaster.zip

The attached Stage 1.1 test package contains the updated localized portmaster.zip for review and testing:

Installation for testing

Important: This package is intended for Portmaster v2.2.1. Back up the original file before testing.

1. Completely shut down Portmaster.

2. Extract the attached Stage 1.1 test package.

3. Back up the original frontend resource file located at:

   C:\Program Files\Portmaster\portmaster.zip
   

4. Copy the localized portmaster.zip from the extracted test package to:

   C:\Program Files\Portmaster\
   

5. Replace the original portmaster.zip.

6. Restart Portmaster.

To restore the official English interface, completely shut down Portmaster and copy the original backup back to:

C:\Program Files\Portmaster\portmaster.zip

Feedback on translation quality, terminology, layout or a possible official i18n architecture would be very welcome.

---

中文说明

这是基于 Portmaster v2.2.1 制作的简体中文前端汉化 Stage 1.1 更新版。

本次更新进一步补充并优化了以下前端内容：

• 网络活动结果数量、分页和筛选文字
• 传入与传出连接标签
• 连接范围和状态说明
• 导入与导出对话框
• 常用确认、成功及错误提示
• 设置页面中的更多前端标签
• SPN 状态、国家和节点说明
• 应用设置与全局设置中的前端文字
• 工具提示、按钮及其他遗漏文字

本次修改仍主要位于：

desktop/angular/

通过现有构建流程生成的中文版前端资源文件位于：

packaging/windows/dev_helpers/dist/portmaster.zip

本次更新没有修改 Portmaster 的网络和安全核心，包括：

• portmaster-core.exe
• Windows 网络过滤驱动
• 防火墙判断逻辑
• DNS 过滤逻辑
• SPN 路由逻辑
• 网络规则

更新版已经在 Windows 上完成编译并进行日常使用测试，目前没有发现因汉化造成的功能问题。

部分设置名称、说明、通知和托盘菜单仍然显示英文，主要是因为这些内容由 Portmaster 核心程序或桌面外壳动态提供。

附件

portmaster.zip

附件中的 Stage 1.1 测试包包含更新后的中文版 portmaster.zip，可用于审查和测试：

安装测试方法

重要提示： 此测试包适用于 Portmaster v2.2.1。替换前请先备份原版文件。

1. 完全关闭 Portmaster。

2. 解压附件中的 Stage 1.1 测试包。

3. 备份以下位置的原版前端资源文件：

   C:\Program Files\Portmaster\portmaster.zip
   

4. 将测试包中的中文版 portmaster.zip 复制到：

   C:\Program Files\Portmaster\
   

5. 替换原版 portmaster.zip。

6. 重新启动 Portmaster。

需要恢复官方英文界面时，请完全关闭 Portmaster，并将原版备份文件恢复到：

C:\Program Files\Portmaster\portmaster.zip

欢迎反馈翻译质量、术语、界面排版，以及未来正式 i18n 多语言架构方面的建议。