install-macos.md

Gõ Nhanh trên macOS

Cài đặt

Cách 1: Homebrew (Khuyến nghị)

brew install --cask gonhanh

Sau đó cấp quyền: System Settings → Privacy & Security → Accessibility → Bật Gõ Nhanh

Cách 2: Tải thủ công

1. Tải về: GoNhanh.dmg

2. Cài đặt: Mở file .dmg → Kéo vào Applications

3. Cho phép chạy: (Lưu ý phải tắt app trước khi chạy)

   xattr -cr /Applications/GoNhanh.app

4. Cấp quyền: Mở app → System Settings → Privacy & Security → Accessibility → Bật GoNhanh

---

Sử dụng

Phím tắt	Chức năng
Ctrl + Space	Bật/tắt tiếng Việt

Telex (mặc định)

Gõ	Kết quả
as, af, ar, ax, aj	á, à, ả, ã, ạ
aa, aw, ee, oo	â, ă, ê, ô
ow, uw, dd	ơ, ư, đ

Đổi sang VNI

Menu Bar → Cài đặt → Kiểu gõ → VNI

Gõ	Kết quả
a1, a2, a3, a4, a5	á, à, ả, ã, ạ
a6, a8, o6, e6	â, ă, ô, ê
o7, u7, d9	ơ, ư, đ

Tính năng khác

• Gõ tắt: Menu Bar → Cài đặt → Gõ tắt → Thêm từ viết tắt
• Ngoại lệ: Menu Bar → Cài đặt → Ngoại lệ → Thêm app không muốn gõ tiếng Việt

---

Nâng cấp

Homebrew:

brew upgrade --cask gonhanh

Thủ công: Menu Bar → Cài đặt → Cập nhật → Tải và cài đặt

---

Gỡ cài đặt

Homebrew:

brew uninstall --cask gonhanh

Thủ công:

1. Menu Bar → Thoát
2. Xóa app từ Applications
3. (Tùy chọn) Xóa cấu hình:

   rm -rf ~/.config/gonhanh ~/Library/Preferences/org.gonhanh.*

---

Xử lý sự cố

App không mở được?

xattr -cr /Applications/GoNhanh.app

Không gõ được tiếng Việt?

1. Kiểm tra icon Menu Bar hiển thị "VN"
2. Nhấn Ctrl + Space
3. Kiểm tra quyền Accessibility đã bật

Sau khi cập nhật macOS:

System Settings → Privacy & Security → Accessibility → Tắt/bật lại GoNhanh

---

Nâng cao

Khởi động cùng hệ thống

System Settings → General → Login Items → Thêm GoNhanh

Yêu cầu hệ thống

• macOS 13.0 (Ventura) trở lên
• Apple Silicon hoặc Intel