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.
Gõ máy ở tốc độ ~380 WPM — dấu bung tức thì, không gạch chân, từ tiếng Anh tự khôi phục.
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.
Trình cài đặt tự đặt app vào đúng chỗ, đăng ký bộ gõ và mở sẵn System Settings — không phải kéo thả, không phải đăng xuất.
Tải VietTelex-x.y.z.pkg (đã được Apple ký & xác thực notarize) rồi nhấp đúp. Hoặc dùng Homebrew: brew install --cask ptrinh/viettelex/viettelex
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). Có thể cần khởi động lại máy một lần để quyền có tác dụ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.
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.