VietTelex (ViệtTelex / ViếtTelex) là bộ gõ Telex mã nguồn mở miễn phí, được xây dựng trên InputMethodKit của macOS để tích hợp sâu: nhanh, tiện, tối giản, mượt cho mọi app.
Miễn phí cho iPhone & iPad · Android · macOS · Windows · Linux
VietTelex trong 33 giây — Telex/VNI, không gạch chân, tự giữ tiếng Anh, gõ vuốt trên điện thoại, có mặt trên mọi nền tảng.
Viết lại từ đầu sau gần 20 năm dùng macOS mà chưa tìm được bộ gõ tiếng Việt nào thật sự ngon, chuẩn, mượt.
Là bộ gõ thật của hệ thống, không phải ứng dụng chặn phím — tự đổi kiểu gõ theo từng ứng dụng, chính tả, gợi ý từ, hoàn tác hay VoiceOver đều hoạt động đúng.
Luật chính tả được biên dịch sẵn thành máy trạng thái, không cấp phát bộ nhớ khi gõ. Gõ nhanh cỡ nào cũng mượt, không mất hay loạn ký tự.
Terminal/iTerm giữ nguyên gợi ý lệnh của shell; thanh địa chỉ Chrome, ô Excel, Spotlight đều gõ đúng — nơi các bộ gõ khác thường vỡ.
Tự khôi phục google, github…; nhận dạng từ viết kiểu camelCase (OmS, JavaScript) để không bỏ dấu nhầm; có chế độ Telex nghiêm ngặt cho lập trình viên.
Không chạy nền tốn CPU, không kết nối mạng, không thu thập bất kỳ dữ liệu nào.
Chọn một cách cài: tải .pkg hoặc Homebrew. Cả hai dùng app đã ký và cài vào ~/Library/Input Methods/VietTelex.app; đừng cài đồng thời vì hai trình quản lý sẽ cùng ghi/xoá app đó. iPhone, Android, Windows, Linux: xem trang tải.
Tải VietTelex-x.y.z.pkg (đã được Apple ký & xác thực notarize) rồi nhấp đúp. Hoặc chạy brew install --cask ptrinh/viettelex/viettelex. Khi đổi kênh, gỡ app khỏi kênh hiện tại trước.
System Settings → Keyboard → Input Sources → Edit… / ＋ → Vietnamese → ViệtTelex → Add.
Chuyển sang ViệtTelex bằng phím 🌐 hoặc ⌃Space. Muốn gõ trong Terminal/iTerm/Chrome thì bật quyền Trợ năng cho VietTelex (Privacy & Security → Accessibility).
Do VietTelex chưa được cấp quyền Trợ năng: System Settings → Privacy & Security → Accessibility → tick VietTelex (đã tick mà vẫn lỗi thì bỏ tick rồi tick lại). Nếu đang chạy bản Debug từ Xcode, thoát bản đó rồi mở bản trong ~/Library/Input Methods; hai bản có định danh quyền riêng.
Đăng xuất/đăng nhập lại một lần rồi thêm lại.
Menu bộ gõ → Cài đặt… → tab Bảng cơ chế gõ → thêm app (có sẵn danh sách app mở gần đây) → ép tay thử lần lượt: Tap (backspace), Gõ trực tiếp, Marked text. Cách nào gõ đúng thì báo về GitHub để bản sau thành mặc định cho mọi người.
Có: Cài đặt… → tab Tùy chỉnh → bật Gõ kiểu VNI.
VietTelex tự tắt trong secure field — đúng hành vi bảo mật, không phải lỗi.
Bấm một dấu cách trước khi ấn Enter là đủ chữ. Hoặc dùng Chrome cho TikTok. Lý do: ô comment của TikTok chỉ ghi nhận từ đang gõ khi có một phím thật đi sau nó — Enter thì không đủ. Bộ gõ đã thử sáu cách xử lý hộ và không cách nào giữ được từ cuối, nên đây là giới hạn đã biết.
Gỡ khỏi Input Sources chỉ tắt bộ gõ, chưa xoá app. Gỡ hẳn: xoá ~/Library/Input Methods/VietTelex.app (Finder → Go → Go to Folder…) rồi đăng xuất/đăng nhập. Muốn xoá luôn cài đặt cá nhân: xoá thêm ~/Library/Preferences/com.viettelex.settings.plist. Cài bằng Homebrew thì chỉ cần brew uninstall --cask viettelex.
Lỗi của framework Qt (Flameshot, OBS, VLC… dùng): shortcut trong overlay bị nuốt khi có bất kỳ bộ gõ nào đang active — bộ gõ Simple Telex có sẵn của Apple cũng dính y hệt, không riêng VietTelex (chi tiết). Khắc phục: System Settings → Keyboard → bật “Automatically switch to a document's input source”, rồi một lần chuyển sang ABC khi đang ở app đó — macOS sẽ tự nhớ, các app khác vẫn gõ tiếng Việt bình thường.
Dự án miễn phí, mã nguồn mở. Nếu thấy hữu ích, bạn có thể ủng hộ tác giả — hoặc gửi góp ý, báo lỗi.
