# VKey

> VKey là bộ gõ tiếng Việt miễn phí, mã nguồn mở (GPL-3.0) cho macOS. Hỗ trợ Telex và VNI, xuất Unicode, hoàn toàn offline, không lưu phím gõ, không cần quyền Accessibility hay Input Monitoring. Bản mới nhất: 0.3.7, file DMG khoảng 540 KB.

## Thông tin chính

- Nền tảng: macOS 13 trở lên, chỉ máy Mac Apple Silicon (arm64). Chưa có bản Intel.
- Kiểu gõ: Telex, VNI. Đổi Việt/Anh bằng Control + Shift.
- Riêng tư: không có tính năng mạng, không thống kê, không theo dõi, không tự cập nhật, không tài khoản. Chỉ giữ tạm từ đang gõ trong RAM.
- Công nghệ: Swift, InputMethodKit của Apple. Ký Developer ID, được Apple notarize.
- Gõ xen tiếng Anh: nếu dấu rơi vào vị trí không hợp lệ trong tiếng Việt, VKey trả lại đúng phím đã gõ (windows, user, google). Không dùng từ điển.
- Backspace xoá một ký tự trong từ đang gõ; Escape trả lại các phím gốc.
- Gỡ cài đặt: nút VI/EN trên thanh menu → Gỡ cài đặt VKey.

## Giới hạn đã biết

- Từ tiếng Anh có dạng âm tiết tiếng Việt sẽ bị thêm dấu (test → tét). Gõ lặp phím dấu (tesst) hoặc chuyển sang English.
- Chữ có phụ âm đôi cần gõ ba lần trong Telex (passs → pass).
- Chưa có gõ tắt, macro, kiểm tra chính tả.
- Một số cụm phụ âm như cr, bl (crôm, micrô) chưa gõ được dấu.

## Cài đặt

- DMG: https://github.com/duongkimhung89/vkey/releases/latest
- Homebrew: `brew install --cask duongkimhung89/vkey/vkey`
- Các bước: kéo VKey.app vào Applications → mở một lần → đăng xuất và đăng nhập lại → Cài đặt hệ thống → Bàn phím → Nhập văn bản → Sửa → + → Tiếng Việt → VKey.

## Liên kết

- Mã nguồn: https://github.com/duongkimhung89/vkey
- Tác giả: Dương Kim Hưng (https://github.com/duongkimhung89)
- Kế thừa phần chuyển dấu từ XKey (https://github.com/xmannv/xkey) và OpenKey (https://github.com/tuyenvm/OpenKey).