VietTelex (ViệtTelex / ViếtTelex) là bộ gõ tiếng Việt Telex và VNI, miễn phí và mã nguồn mở, cho iPhone, iPad, Android, macOS, Windows và Linux. Cài xong là gõ; nhanh, gọn, gõ đúng trong mọi app.
Dự án của Phil Trịnh, bắt đầu trên macOS sau gần 20 năm chưa thấy bộ gõ tiếng Việt nào thật sự ngon, chuẩn, mượt, nay có đủ cho điện thoại và máy tính.
https://github.com/user-attachments/assets/1d9bdef1-f814-4070-9b2d-01436f7d3020
Điểm nổi bật
- Bàn phím thật của hệ thống — tích hợp thẳng vào iOS, Android, macOS, Windows và Linux; không phải ứng dụng chặn phím.
- Phản hồi nhanh — xử lý mỗi phím trong khoảng 130 ns theo benchmark trên Mac; gõ liên tục vẫn mượt.
- Gõ đúng ở những chỗ khó — terminal, thanh địa chỉ trình duyệt, Excel, Word.
- Giữ nguyên tiếng Anh và mã lệnh —
google, github, JavaScript… không bị bỏ dấu nhầm.
- Đầy đủ trên điện thoại — gợi ý từ, gõ vuốt, mẫu câu, clipboard, emoji, giao diện tuỳ chỉnh.
- Độ chính xác được kiểm thử — 9.091 trường hợp: đúng 100% từ tiếng Việt, khôi phục 98,9% từ tiếng Anh (chi tiết).
- Riêng tư — không thu thập nội dung bạn gõ, không quảng cáo, không theo dõi (chi tiết).
| macOS: menu trên thanh menu | macOS: cửa sổ Cài đặt |
|---|
| |
Cài đặt
Tải và hướng dẫn từng bước: viettelex.com/download · Hướng dẫn sử dụng: viettelex.com/hdsd
- iPhone & iPad — App Store, rồi thêm VietTelex trong Cài đặt → Bàn phím.
- Android — Google Play hoặc APK, mở app rồi bấm Bật VietTelex.
- Windows — Microsoft Store,
.msi, winget install ptrinh.VietTelex hoặc bản portable; cài xong là gõ được.
- Linux —
curl -fsSL https://viettelex.com/install.sh | bash
- macOS —
.pkg hoặc brew install --cask ptrinh/viettelex/viettelex
Chọn một cách cài: Homebrew hoặc .pkg. Cả hai cài cùng app đã ký vào
~/Library/Input Methods/VietTelex.app; không cài song song vì hai bộ quản lý sẽ
cùng ghi/xoá một app. Khi đổi từ Homebrew sang .pkg, chạy
brew uninstall --cask viettelex trước. Khi đổi từ .pkg sang Homebrew, chuyển
sang ABC, thoát VietTelex, xoá app ở đường dẫn trên rồi mới chạy lệnh Homebrew.
- Nếu chọn
.pkg, tải VietTelex-x.y.z.pkg ở trang tải hoặc Releases (đã ký + notarized).
- Double-click → làm theo hướng dẫn (tự cài vào thư mục user, đăng ký bộ gõ, mở sẵn System Settings → Keyboard).
- Input Sources → Edit… / ＋ → Vietnamese → ViệtTelex → Add.
| ① Input Sources → Edit… | ② ＋ → Vietnamese → ViệtTelex → Add |
|---|
| |
Để gõ trong Terminal, iTerm, Chrome/Edge/Brave: cấp quyền cho VietTelex trong Privacy & Security → Accessibility (macOS 26 trở về trước) / Device Control and Data Access (macOS 27). Chuyển Việt/Anh bằng phím 🌐 hoặc ⌃Space (macOS nhớ theo từng app).
Cách gõ
s f r x j = sắc huyền hỏi ngã nặng · aa ee oo = â ê ô · aw ow uw = ă ơ ư · dd = đ · z xóa dấu.
Ví dụ: vieejt → việt · truowngf → trường · hoas → hóa.
Chọn Telex hay VNI và các tuỳ chọn khác trong Cài đặt của VietTelex trên từng nền tảng.
Gõ kiểu VNI: dấu gõ bằng số: 1-5 = sắc/huyền/hỏi/ngã/nặng, 6 = â/ê/ô, 7 = ơ/ư, 8 = ă, 9 = đ, 0 = bỏ dấu (ví dụ Vie6t5 → Việt). Nên bật Kiểm tra chính tả khi gõ để các chuỗi như mp3 không bị hiểu nhầm thành dấu.
FAQ — câu hỏi thường gặp
Các câu dưới đây dành cho macOS. Windows, Linux, iPhone và Android: xem hướng dẫn sử dụng.
Nếu chữ bị gạch chân, có thể VietTelex chưa được cấp quyền. Mở Cài đặt hệ thống (System Settings) → Quyền riêng tư & Bảo mật (Privacy & Security) → Trợ năng (Accessibility, macOS 26 trở về trước) / Điều khiển thiết bị và truy cập dữ liệu (Device Control and Data Access, macOS 27), rồi bật VietTelex. Lưu ý: mục "Trợ năng" ở thanh bên trên macOS 27 là cài đặt hỗ trợ nhìn/nghe, không phải chỗ cấp quyền. Nếu đã bật mà vẫn lỗi, hãy chọn VietTelex, bấm − để xoá rồi bấm + thêm lại (từ ~/Library/Input Methods). Có thể cần khởi động lại máy để quyền có hiệu lực.
Nếu đã bật quyền mà VietTelex vẫn báo thiếu, hãy kiểm tra bản đang chạy. Bản Debug
trong Xcode có định danh riêng và không dùng quyền của bản cài trong
~/Library/Input Methods; thoát bản Debug rồi mở lại bản đã cài. Nếu bản đã cài
vẫn báo thiếu, xoá mục VietTelex khỏi Accessibility rồi thêm lại ứng dụng trong
~/Library/Input Methods.
Hiếm gặp, thường do quyền còn "kẹt" với bản cài cũ. Cập nhật lên bản mới nhất trước (từ 1.8.32 VietTelex tự nhận quyền vừa bật, không cần khởi động lại). Nếu vẫn báo thiếu:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
