BongoCat i18n

Trong lúc tìm hiểu và cài thử ayangweb/BongoCat, mình nhận thấy UI và bộ cài đặt chủ yếu là tiếng Trung. Mình thì lại khó hiểu tiếng Trung (hơi bực 😅) nên quyết định fork về, dịch ra và i18n hóa (đa ngôn ngữ). Giữ nguyên toàn bộ tính năng gốc, tập trung thêm i18n và bộ cài đặt có chọn ngôn ngữ.

---

🌏 English Summary

While exploring and installing ayangweb/BongoCat, I found that most of the UI and installer were in Chinese. I don’t understand Chinese well (a bit frustrated 😅), so I decided to fork it, translate, and add i18n (multi-language support). All original features remain intact, focusing on i18n and language selection during installation.

---

⬇️ Tải về (chỉ bản Windows) / Download (Windows build only)

• GitHub Releases

---

🎨 Model khác / Other models

🇻🇳 Ngoài model mặc định, bạn có thể tải thêm nhiều model khác từ
🇬🇧 Besides the default model, you can download more models from
ayangweb/Awesome-BongoCat.

---

🏗 Nguồn gốc dự án / Project origins

Khi tìm hiểu về BongoCat, mình phát hiện dự án có một lịch sử khá thú vị. (While researching BongoCat, I found that the project has a rather interesting history:)

1. HamishDuncanson

   • 🇻🇳 Theo chia sẻ của kuroni, Hamish là người đã tạo ra ý tưởng gốc: 🇬🇧 According to kuroni, Hamish was the one who created the original idea: "An osu! Bongo Cat overlay with smooth paw movement and simple skinning ability, written in C++."

2. kuroni/bongocat-osu

   • 🇻🇳 Là người Việt, tiếp tục phát triển dự án dựa trên ý tưởng của Hamish. 🇬🇧 A Vietnamese developer, continued to develop the project based on Hamish’s idea.

3. MMmmmoko/Bongo-Cat-Mver (fork từ kuroni)

   • 🇻🇳 Viết lại nhiều logic, hoạt động như một "decorative operation demo". 🇬🇧 Rewrote much of the logic, functioning as a "decorative operation demo".
   • 🇻🇳 Chỉ hỗ trợ Windows và hiện đã archive. 🇬🇧 Only supported Windows and is now archived.

4. ayangweb/BongoCat (không phải fork, viết lại từ đầu)

   • 🇻🇳 Lấy cảm hứng từ MMmmmoko. 🇬🇧 Inspired by MMmmmoko.
   • 🇻🇳 Viết lại bằng Tauri, hỗ trợ đa nền tảng (macOS, Windows, Linux x11). 🇬🇧 Rewritten with Tauri, supporting multiple platforms (macOS, Windows, Linux x11).

5. cuonglmptit/bongocat-i18n (repo này)

   • 🇻🇳 Fork từ ayangweb/BongoCat để dịch, i18n hóa UI và installer, giúp nhiều người dùng hơn có thể tiếp cận. 🇬🇧 Forked from ayangweb/BongoCat to translate, add i18n for the UI and installer, making it more accessible to more users.

---

Instructions

🌐 🇻🇳 Thêm ngôn ngữ mới / 🇬🇧 Add a new language

🇻🇳 Vì mình không thể dịch hết sang tất cả các ngôn ngữ, bạn có thể dựa vào file tiếng Anh (en.json) để dịch sang ngôn ngữ của bạn.
🇬🇧 Since I can't translate into all languages, you can use the English file (en.json) as a base and translate it into your language.

1. 🇻🇳 Mở thư mục assets/locales. 🇬🇧 Open the assets/locales folder.

2. 🇻🇳 Copy một file có sẵn (ví dụ: en.json) và đổi tên thành mã ngôn ngữ bạn muốn (ví dụ: fr.json). 🇬🇧 Copy an existing file (e.g., en.json) and rename it to the language code you want (e.g., fr.json).

3. 🇻🇳 Dịch lại nội dung trong file, ví dụ: 🇬🇧 Translate the contents of the file, for example:

   {
     "meta": { "name": "English" },
     "menu": {
       "cat": "Cat Settings",
       "general": "General"
     }
   }

4. 🇻🇳 Lưu file và khởi động lại ứng dụng để áp dụng.
   🇬🇧 Save the file and restart the app to apply.

---

🇻🇳 Bạn cũng có thể tự tải source về, thêm file JSON ngôn ngữ mới vào assets/locales và build lại để tạo bộ cài sẵn ngôn ngữ này. 🇬🇧 You can also download the source, add your new language JSON file into assets/locales, and build again to create an installer with this language included.

Ví dụ build lại / Build example:

Test:

pnpm install
pnpm tauri dev

Build:

pnpm install
pnpm tauri build

---

Tính năng chính / Features

• Giữ nguyên các tính năng của ayangweb/BongoCat (Keep all original features from ayangweb/BongoCat):
  • Đa nền tảng: macOS, Windows, Linux (x11) (Cross-platform: macOS, Windows, Linux (x11))
  • Hỗ trợ model tùy chỉnh (Support for custom models)
  • Chạy offline, không thu thập dữ liệu người dùng (Works offline, no user data collection)
• Mới: UI hỗ trợ đa ngôn ngữ (i18n) (New: UI supports multi-language (i18n))
• Mới: Installer (NSIS) có thể chọn ngôn ngữ khi cài đặt (New: Installer (NSIS) supports language selection during setup)

⚠️ 🇻🇳 Lưu ý: Bản phát hành chính thức hiện tại chỉ build sẵn cho Windows. Các hệ điều hành khác (macOS, Linux) có thể tự tải source về, build và test. Mình không chịu trách nhiệm cho các bản build tự thực hiện.

⚠️ 🇬🇧 Note: Official release currently only builds for Windows. Other operating systems (macOS, Linux) can download the source, build and test. I’m not responsible for self-built versions.

---

License

MIT

---

Credits

• HamishDuncanson
  🇻🇳 Ý tưởng gốc (theo chia sẻ của kuroni)
  🇬🇧 Original idea (according to kuroni)

• kuroni
  🇻🇳 Phát triển bongocat-osu (người Việt 🇻🇳)
  🇬🇧 Developed bongocat-osu (Vietnamese developer 🇻🇳)

• MMmmmoko
  🇻🇳 Tạo Bongo-Cat-Mver (fork từ kuroni)
  🇬🇧 Created Bongo-Cat-Mver (forked from kuroni)

• ayangweb
  🇻🇳 Viết lại đa nền tảng bằng Tauri
  🇬🇧 Rewrote as a cross-platform version using Tauri ======= 简体中文| English

macOS	Windows	Linux(x11)

赞助商

开发背景

本项目的灵感来源于 MMmmmoko 大佬开发的 Bongo-Cat-Mver。它以独特的猫咪互动功能深受用户喜爱，但仅支持 Windows 平台。作为一名深度 macOS 用户，我特别希望在自己的设备上也能使用这款可爱的猫咪，于是我决定开发一个适配 macOS 的版本。

同时，得益于 Tauri 强大的跨平台能力，本项目不仅支持 macOS，还兼容 Windows 和 Linux(x11)，让更多的用户都能与这只可爱的猫咪互动！

下载

• 夸克网盘
• GitHub Releases

不确定下载哪一个？请查阅下载指南。

功能介绍

• 适配 macOS、Windows 和 Linux(x11)。
• 根据键盘、鼠标或手柄的操作，同步对应的动作。
• 支持导入自定义模型，自由打造专属猫咪形象。
• 完全开源，代码公开透明，绝不收集任何用户数据。
• 支持离线运行，无需联网，保护用户隐私。

模型转换

如果你想将 Bongo-Cat-Mver 应用中的模型转换为兼容 BongoCat 的格式，可以使用以下工具：

🔗 在线转换

更多模型

你可以在这个仓库中探索、下载更多猫咪模型，或提交你的创作，与大家一起分享：

📦 Awesome-BongoCat

社区交流

贡献指南

感谢大家为 BongoCat 做出的宝贵贡献！如果你也希望为 BongoCat 做出贡献，请查阅贡献指南。

历史星标