https://github.com/khaphanspace/gonhanh.org
Gõ Nhanh - Bộ gõ tiếng Việt hiện đại, hiệu suất cao dành cho macOS.
https://github.com/khaphanspace/gonhanh.org
Last synced: 2 months ago
JSON representation
Gõ Nhanh - Bộ gõ tiếng Việt hiện đại, hiệu suất cao dành cho macOS.
- Host: GitHub
- URL: https://github.com/khaphanspace/gonhanh.org
- Owner: khaphanspace
- License: bsd-3-clause
- Created: 2025-12-06T11:18:15.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-30T00:13:36.000Z (3 months ago)
- Last Synced: 2026-03-30T03:53:13.640Z (2 months ago)
- Language: Rust
- Homepage: https://gonhanh.org/
- Size: 14.4 MB
- Stars: 671
- Watchers: 8
- Forks: 86
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Gõ Nhanh
Bộ gõ tiếng Việt miễn phí, nhanh, ổn định cho macOS.
Cài là dùng. Không quảng cáo. Không thu thập dữ liệu.
---
## 🌟 Contributors
💖 Sponsors (8)
blueberry6401
nguyencaokyvn
trinhquocviet
vienkmt
ducfilan
💻 Code (6)
khaphanspace
tuananhht94
brotherbui
sonnh-uit
zeldrisho
💬 Cộng đồng (111)
m0n99
voquanghoa
ducfilan
duynguyeenx96
ngthminhdev
Xem danh sách đầy đủ tại [CONTRIBUTORS.md](CONTRIBUTORS.md).
---
## 📥 Tải về & Cài đặt
### 🍺 Homebrew (macOS - Khuyến nghị)
```bash
brew install --cask gonhanh
```
> **Cập nhật:** App tự động kiểm tra phiên bản mới mỗi 24h. Hoặc dùng `brew upgrade --cask gonhanh`.
### 📦 Tải thủ công
| Nền tảng | Trạng thái | Tải xuống | Hướng dẫn |
| :---------: | :---------: | :----------------------------------------------------------------------------------------------------: | :--------------------------------------- |
| **macOS** | ✅ Sẵn sàng | [📥 Tải GoNhanh.dmg](https://github.com/khaphanspace/gonhanh.org/releases/latest/download/GoNhanh.dmg) | [Xem hướng dẫn](docs/install-macos.md) |
| **Linux** | 🧪 Beta | — | [Xem hướng dẫn](docs/install-linux.md) |
| **Windows** | 🧪 Beta | — | [Xem hướng dẫn](docs/install-windows.md) |
⚠️ macOS: App không mở được?
```bash
# Chạy lệnh này trong Terminal sau khi kéo app vào Applications
xattr -cr /Applications/GoNhanh.app
```
Sau đó: **System Settings → Privacy & Security → Accessibility → Bật GoNhanh**
⚠️ Bị nuốt chữ khi dùng Claude Code trong IDE (VS Code, Cursor, Windsurf...)?
1. **Menu bar** → icon Gõ Nhanh → **Cài đặt** → tab **Nâng cao**
2. Phần "Tuỳ chỉnh theo ứng dụng" → nhấn **+** → chọn IDE đang dùng
3. Kéo thanh **Delay** sang phải → **"Rất cao"** (tím)
4. Tự động lưu, xong.
> Mỗi máy, mỗi IDE có độ trễ phản hồi khác nhau, hãy tuỳ chỉnh mức delay cho phù hợp.
## ✨ Tính năng
### 🔥 Highlight
- 🔍 **Fix lỗi Chrome/Spotlight/Arc/Claude Code/JetBrains** - Tự động sửa dính chữ trong address bar, thanh tìm kiếm, Arc history
- 🔤 **Auto-restore tiếng Anh** — Gõ `text` `expect` `user` `push` `sort` → tự khôi phục khi nhấn space. [Xem chi tiết ↓](#-auto-restore-tiếng-anh)
- ⎋ **Gõ ESC tự khôi phục** — Gõ `user` → `úẻ` → nhấn **ESC** → `user`. Không cần tắt bộ gõ khi gõ tiếng Anh!
- 🧠 **Chuyển chế độ thông minh** — Tự nhớ ON/OFF cho từng app. Code trên VS Code (tắt) → Chat trên Slack (bật) → tự chuyển
- 🔄 **Tự động theo input source** — Dùng tiếng Nhật, Hàn, Trung... → Gõ Nhanh tự tắt. Chuyển về tiếng Anh → tự bật lại
- ⚡ **Siêu nhanh** — <10ms latency · ~20MB RAM. Hỗ trợ đa nền tảng trên cùng một engine
### 📋 Đầy đủ
- ⌨️ **Telex & VNI** — Chọn kiểu gõ quen thuộc
- 🎯 **Đặt dấu chuẩn** — Tự động theo [quy tắc mới](https://vi.wikipedia.org/wiki/Quy_t%E1%BA%AFc_%C4%91%E1%BA%B7t_d%E1%BA%A5u_thanh_c%E1%BB%A7a_ch%E1%BB%AF_Qu%E1%BB%91c_ng%E1%BB%AF): `hoà`, `khoẻ`, `thuỷ`
- 🔠 **Tự viết hoa đầu câu** — Gõ `ok.` Space `b` → `B` hoa. Hỗ trợ `.` `!` `?` và Enter
- ✂️ **Gõ tắt** — `vn` → `Việt Nam`, `ko` → `không`
- 🔌 **Mọi app** — Claude Code, VS Code, Zed, Chrome, Notion, Terminal, Ghostty...
- 🌗 **Dark/Light** — Theo hệ thống
- 💻 **Đa nền tảng** — macOS, Linux, Windows (beta)
### 🛡️ Cam kết "Ba Không"
- 🚫 **Không thu phí** — Miễn phí mãi mãi, không bản Pro
- 🚫 **Không quảng cáo** — Không popup, không làm phiền
- 🚫 **Không theo dõi** — Offline 100%, mã nguồn mở
---
## 🔤 Auto-restore tiếng Anh
Khi gõ tiếng Anh bằng Telex, một số chữ cái bị nhận nhầm thành dấu tiếng Việt (`s` → sắc, `w` → ư...). **Gõ Nhanh tự động khôi phục** khi nhấn **Space**.
### 📝 So sánh: macOS Telex vs Gõ Nhanh
| Gõ | macOS Telex | Gõ Nhanh |
| :--------- | :---------- | :------------ |
| `text ` | `têt ` ❌ | `text ` ✅ |
| `expect ` | `ễpct ` ❌ | `expect ` ✅ |
| `perfect ` | `pềct ` ❌ | `perfect ` ✅ |
| `with ` | `ưith ` ❌ | `with ` ✅ |
| `tesla ` | `téla ` ❌ | `tesla ` ✅ |
| `luxury ` | `lủuy ` ❌ | `luxury ` ✅ |
| `case ` | `cáe ` ❌ | `case ` ✅ |
| `wow ` | `ươ ` ❌ | `wow ` ✅ |
### ⚠️ Giới hạn
Một số từ tiếng Anh tạo ra cấu trúc **hợp lệ tiếng Việt** nên không thể tự nhận diện:
| Từ Anh | Kết quả Telex | Lý do |
| :----- | :------------ | :----------- |
| `mix` | `mĩ` | M + ĩ hợp lệ |
| `box` | `bõ` | B + õ hợp lệ |
| `six` | `sĩ` | S + ĩ hợp lệ |
**Giải pháp:** Nhấn **ESC** sau khi gõ để khôi phục, hoặc tắt bộ gõ tạm thời (⌘+Space).
---
## ❤️🔥 Động lực
Tôi (**Kha Phan**) bắt đầu dự án này vì các bộ gõ hiện tại thường xuyên gặp lỗi khi tôi làm việc với **Claude Code**.
Từ nhu cầu giải quyết vấn đề cá nhân, Gõ Nhanh được phát triển thành một sản phẩm hoàn thiện dành tặng cộng đồng. Đây cũng là sự tiếp nối và kế thừa từ **UniKey**, **OpenKey** và **EVKey**.
Hy vọng Gõ Nhanh góp phần truyền cảm hứng cho cộng đồng mã nguồn mở tại Việt Nam.
Nếu các bạn thấy phần mềm hữu ích có thể [ủng hộ tôi tại đây](https://github.com/sponsors/khaphanspace).
---
## 🔧 Tài liệu kỹ thuật
- [Hướng dẫn phát triển](docs/development.md) — Build, test, contribute
- [Kiến trúc hệ thống](docs/system-architecture.md) — FFI, luồng dữ liệu, app compatibility
- [Thuật toán xử lý](docs/core-engine-algorithm.md) — Pipeline 7 giai đoạn
- [Quy tắc kiểm tra âm tiết](docs/validation-algorithm.md) — 5 quy tắc kiểm tra âm tiết
- [Hệ thống chữ viết tiếng Việt & Phương pháp gõ](docs/vietnamese-language-system.md) — Cơ sở ngôn ngữ học
---
## ⭐ Star History
[](https://www.star-history.com/#khaphanspace/gonhanh.org&type=Timeline&legend=bottom-right)
---
## 📄 License
Copyright © 2025 Gõ Nhanh Contributors. [BSD-3-Clause](LICENSE).