← ViệtTelex

Hướng dẫn sử dụng

Mọi tính năng của ViệtTelex — kể cả những cử chỉ “ẩn” không có nút bấm — trên iPhone/iPad, Android, macOS, Windows và Linux.

Cài đặt & bật bộ gõ

iPhone / iPad

Tải VietTelex trên App Store (trang tải), rồi vào Cài đặt → Cài đặt chung → Bàn phím → Bàn phím → Thêm bàn phím mới… → VietTelex. Khi gõ, bấm 🌐 để chuyển sang VietTelex. Ô Thử gõ trong app để kiểm tra ngay: vieejt → việt.

Android

Tải ở trang tải. Cài đặt → Hệ thống → Ngôn ngữ & nhập liệu → Bàn phím trên màn hình → Quản lý → bật VietTelex, rồi chọn VietTelex làm bàn phím (app có nút Chọn VietTelex). Cảnh báo “có thể thu thập mọi văn bản bạn nhập” là cảnh báo chung của Android cho mọi bàn phím bên thứ ba — VietTelex chạy hoàn toàn trên máy.

Hầu hết cài đặt trong app áp dụng ở lần mở bàn phím kế tiếp.

macOS

  • Cài một trong hai cách: tải VietTelex-x.y.z.pkg (đã ký & notarize) rồi nhấp đúp, hoặc brew install --cask ptrinh/viettelex/viettelex. Đừng cài song song hai kênh.
  • Trình cài tự mở Cài đặt hệ thống → Bàn phím: Nguồn đầu vào → Sửa… → + → Tiếng Việt → ViệtTelex → Thêm.
  • Để gõ được trong Terminal, iTerm, Chrome/Edge/Brave: vào Quyền riêng tư & Bảo mật → Trợ năng (macOS 26 trở về trước) / Điều khiển thiết bị và truy cập dữ liệu (macOS 27) → bật VietTelex; có thể cần khởi động lại máy một lần.
  • Chuyển Việt/Anh bằng 🌐 hoặc ⌃Space như mọi bộ gõ của macOS (macOS nhớ theo từng app). Cài đặt của VietTelex: biểu tượng Vᴛ trên thanh menu → Cài đặt….

Windows — cài trong 3 bước

  1. Tải: Microsoft Store, hoặc nút tải Windows ở trang tải (tự chọn đúng bản x64 hay ARM64 cho máy bạn). Cần Windows 10 1903 trở lên; file cài đã ký số.
  2. Chạy file cài — không cần khởi động lại, không cần chọn gì trong danh sách bàn phím: VietTelex tự thêm mình, đặt làm bàn phím mặc định và bật ngay.
  3. Thấy chữ V ở khay (góc phải thanh tác vụ, có thể nằm dưới mũi tên ^) và cửa sổ Đã sẵn sàng mở ra: gõ thử vieejt → việt. Đổi Việt/Anh bằng CtrlShift hoặc bấm vào chữ V/E.

VietTelex, không phải “Vietnamese Telex” của Windows. Windows có sẵn một bàn phím tên “Vietnamese Telex” — đó là bàn phím khác, không có các tính năng của VietTelex. Khi chuyển bằng WinSpace, hãy chọn dòng VietTelex. Nếu danh sách có cả hai, màn chào và Cài đặt có nút Xử lý… để gỡ bàn phím trùng tên khỏi danh sách (chỉ gỡ khỏi danh sách, thêm lại được).

Không gõ được?

  • Biểu tượng khay mờ = VietTelex đang tắt vì bàn phím khác đang được chọn: bấm vào nó để bật lại.
  • Không thấy biểu tượng: mở VietTelex từ menu Start — mở app là bật bộ gõ. Thoát VietTelex (chuột phải biểu tượng khay) trả về bàn phím bạn dùng trước đó.
  • Thấy E: đang ở tiếng Anh, bấm CtrlShift (bấm rồi nhả) hoặc bấm biểu tượng.
  • Mỗi dấu bị bỏ hai lần (vieejt → viêệt): đang có một bộ gõ tiếng Việt khác chạy cùng lúc — thoát nó từ khay của nó, hoặc bấm Xử lý… trong Cài đặt → Kiểu gõ.
  • App chạy bằng quyền quản trị (Run as administrator) vẫn gõ được với bản cài; riêng bản portable thì không.

Nâng cấp: Microsoft Store tự cập nhật; bản .msi thì cài bản mới đè lên bản cũ, hoặc bấm Kiểm tra cập nhật trong app.

Windows — bản portable (không cần cài)

Cho máy không có quyền cài đặt hoặc muốn thử nhanh. Tải file VietTelex-…-portable-x64.zip (hoặc -arm64) ở trang tải, giải nén cả thư mục rồi chạy VietTelex.exe. Không cần quyền quản trị; xoá thư mục là gỡ xong.

  • Khay, CtrlShift và màn chào giống bản cài. Cài đặt lưu trong settings.ini cạnh VietTelex.exe (thư mục chỉ đọc thì lưu ở %APPDATA%\VietTelex). Không đụng tới danh sách bàn phím của Windows.
  • Đánh đổi: bản portable gõ bằng cách nghe phím toàn hệ thống (hook bàn phím) — gõ trực tiếp, không gạch chân, nhưng trong trình duyệt và Word không mượt bằng bản cài; không gõ được vào app chạy quyền quản trị và một số game; ô mật khẩu của trình duyệt không nhận ra được (hãy chuyển sang E khi gõ mật khẩu).
  • Khởi động cùng Windows: tuỳ chọn trong menu chuột phải ở khay (mặc định tắt).
  • Không tự cập nhật: Kiểm tra cập nhật mở trang tải để lấy file zip mới.
  • Giải nén trước (chuột phải file zip → Giải nén tất cả): chạy thẳng từ trong file zip thì chỉ hiện lời nhắc giải nén.
  • Bản portable không có trong danh sách bàn phím của Windows (WinSpace): cứ để bàn phím tiếng Anh, bật/tắt tiếng Việt bằng CtrlShift hoặc biểu tượng ở khay. Khi đang chọn một bàn phím tiếng Việt, bản portable nhường.
  • Máy đã cài VietTelex và bản cài đang chạy: bản portable báo rồi thoát (không gõ chồng lên nhau). Muốn dùng bản portable, bấm chuột phải biểu tượng VietTelex ở khay → Thoát VietTelex trước.

Linux (Ubuntu 22.04 / 24.04, amd64 + arm64)

VietTelex là input method cho Fcitx5 (khuyên dùng) hoặc IBus (mặc định của Ubuntu/GNOME). Nhanh nhất: curl -fsSL https://viettelex.com/install.sh | bash (xem trang tải). Hoặc tự thêm kho APT (tự cập nhật qua apt upgrade):

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://ptrinh.github.io/viettelex-apt/viettelex-archive-keyring.gpg \
  | sudo tee /etc/apt/keyrings/viettelex.gpg >/dev/null
sudo tee /etc/apt/sources.list.d/viettelex.sources >/dev/null <<EOF
Types: deb
URIs: https://ptrinh.github.io/viettelex-apt/
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: main
Signed-By: /etc/apt/keyrings/viettelex.gpg
EOF
sudo apt update
sudo apt install viettelex-fcitx5   # hoặc: sudo apt install viettelex-ibus
  • Hoặc tải các file .deb (kèm SHA256) ở trang tải (~jammy1 = 22.04, ~noble1 = 24.04) rồi sudo apt install ./libviettelex-core_*.deb ./viettelex-fcitx5_*.deb ./viettelex-settings_*_all.deb — cách này không tự cập nhật.
  • Sau khi cài, mở VietTelex trong menu ứng dụng (hoặc viettelex-settings --onboarding) và làm theo hướng dẫn. Fcitx5: im-config -n fcitx5, đăng nhập lại (lần đầu), rồi bấm Thêm. IBus (GNOME): ibus restart, rồi Cài đặt → Bàn phím → Nguồn nhập → + → Tiếng Việt → VietTelex (hoặc bấm Thêm trong hướng dẫn).
  • Chuyển Việt/Anh: CtrlSpace. Đổi cài đặt trong app có hiệu lực ngay, không cần khởi động lại bộ gõ.

Kiểu gõ Telex / VNI

Tab Kiểu Gõ trong app. macOS Cài đặt… → tab Tùy chỉnh. Windows Cài đặt → tab Kiểu gõ và Chính tả. Linux app VietTelex → tab Kiểu gõ và Tuỳ chỉnh. Telex và VNI loại trừ nhau.

  • VNI — dấu bằng số khi đang gõ một từ: 1 sắc, 2 huyền, 3 hỏi, 4 ngã, 5 nặng, 6 mũ (â ê ô), 7 móc (ơ ư), 8 trăng (ă), 9 đ, 0 xoá dấu: tie6ng1 vie6t5 → tiếng việt. Ngoài từ, phím số vẫn ra số. Chọn VNI tự bật Hàng phím số.
  • Telex đơn giản — w đứng lẻ giữ nguyên là w, không thành ư.
  • Bỏ dấu tự do — phím dấu đặt đâu trong từ cũng được.
  • Gõ nhanh (Quick Telex) — phụ âm đôi đầu từ: cc → ch, nn → ng, tt → th…
  • Bỏ dấu kiểu mới — hoà, thuý thay vì hòa, thúy.
  • Phím ngoặc: [ ra ơ, ] ra ư (mặc định tắt) — cho ai quen gõ phím ngoặc ra ơ/ư: th[ → thơ. Nếu gõ code nên để tắt. macOS Windows Linux
  • Tự động viết hoa đầu câu (mặc định bật) — shift tự bật ở đầu ô, sau . ! ? và khi xuống dòng. Trên iPhone, công tắc “Tự động viết hoa” trong Cài đặt → Bàn phím không áp dụng cho bàn phím bên thứ ba — tắt ở đây. iOS Android
  • Quyết định theo ngữ cảnh — sau một từ tiếng Anh, từ nhập nhằng kế tiếp giữ tiếng Anh: “he is” không thành “he í”.
  • Khi từ vừa là tiếng Anh vừa là tiếng Việt (last/lát, list/lít, his/hí): mặc định ưu tiên tiếng Việt — gõ đúp phím dấu để giữ tiếng Anh (lisst → list). macOS Windows Linux
  • Tự khôi phục từ tiếng Anh — từ không phải tiếng Việt trả về như đã gõ (google, github…). Kiểm tra chính tả khi gõ ngừng bỏ dấu ngay khi từ không thể là tiếng Việt.
  • Chính tả teencode (mặc định tắt) — chấp nhận wá, zui zẻ, kó, bíe, thík, gòy, ừk.
  • Bố cục bàn phím — gõ Telex trên Colemak, Dvorak…; để “theo bộ gõ trước” thì dùng bố cục của nguồn nhập bạn vừa chuyển từ đó. macOS

Sửa dấu từ đã gõ

Quên dấu? Không cần xoá cả từ gõ lại. Bật/tắt ở Tính Năng → Chính tả & sửa lỗi → Sửa dấu từ đã gõ (mặc định bật). macOS luôn bật. Windows tab Chính tả → Gõ thêm dấu cho từ trước con trỏ. Linux tab Tuỳ chỉnh → Gõ thêm dấu cho từ ngay trước con trỏ.

  • Xoá dấu cách để mở lại từ: tháy ␣ ⌫ a → thấy.
  • Đặt con trỏ ngay sau một từ rồi gõ phím dấu s f r x j: viêt + j → việt; chao + f → chào (VNI: số 1–5, 0).
  • Linux Chỉ có ở app cho bộ gõ sửa chữ quanh con trỏ (nhiều app GTK/Qt); không có ở terminal, trình duyệt và các app khác.

Cử chỉ ẩn trên bàn phím

Không có nút nào cho những thao tác này — hãy thử ngay.

Cử chỉTác dụng
Giữ phím cách rồi kéoBiến bàn phím thành trackpad di con trỏ: kéo ngang từng ký tự, kéo dọc từng dòng; kéo nhanh thì con trỏ đi xa hơn. Nhả tay không chèn dấu cách. iOS Android
Vuốt sang trái trên ⌫Xoá theo từ: kéo càng xa càng nhiều từ, nhãn trên phím báo trước số từ sẽ xoá (“⌫ 2 từ” / “−2”); kéo ngược về = huỷ. Nhấc tay mới xoá. Ngay sau đó thanh gợi ý có ô Khôi phục để lấy lại (mất khi gõ phím khác). iOS Android
Giữ ⌫Xoá lặp, nhanh dần; giữ quá ~3 giây chuyển sang xoá cả từ. iOS Android
Chạm C / X / V rồi vuốt thẳng lên quá hàng phím trên cùng, nhấc taySao chép / Cắt / Dán — theo vị trí phím QWERTY, Telex hay VNI đều vậy. Nhãn nhỏ báo trước lệnh (hoặc lý do không chạy được, vd “Chưa chọn chữ”); kéo ngón trở xuống hàng phím = huỷ, chữ vẫn gõ như thường. Android thêm A chọn hết, Z hoàn tác, Y làm lại (app hỗ trợ). iOS không cho bàn phím chọn chữ, chọn hết hay hoàn tác/làm lại; sao chép, cắt, dán cần Truy cập đầy đủ. Mặc định tắt — bật ở Tính Năng → Phím & cử chỉ → “Vuốt phím để sao chép/dán”. iOS Android
Giữ ⇧ rồi kéo phím cáchChọn chữ thay vì di con trỏ: kéo ngang mở rộng vùng chọn từng ký tự, kéo dọc theo dòng. Cần bật “Vuốt phím để sao chép/dán”. Android
Chạm đúp phím cáchRa “. ” (dấu chấm + cách) sau chữ/số. iOS Android
Chạm . , ? ! ) " ' : ; ở bàn số / ký hiệuTự về bàn chữ ngay, không cần dấu cách. Ngay sau chữ số thì . , : ở lại bàn số (2.5 · 1,000 · 10:30). Đổi ở Tính Năng → Phím & cử chỉ → “Về bàn chữ sau ký hiệu”: Tự động (mặc định, như trên) · Luôn (sau mọi ký hiệu, số thì ở lại) · Tắt (chỉ dấu cách đưa về chữ). iOS Android
Chạm đúp ⇧Khoá chữ hoa (Caps Lock). Đầu câu bàn phím tự bật chữ hoa. iOS Android
⌫ ngay sau khi từ tự khôi phục / gõ tắt vừa bungTrả lại chữ bạn đã gõ (hoàn tác gõ tắt) hoặc hiện dạng có dấu trên thanh gợi ý để đổi bằng một chạm.
Giữ lâu nút ☰ trên thanh gợi ýBật/tắt chế độ một tay (chỉ iPhone). Khi tắt Mẫu câu, chỗ nút ☰ là nút một tay — chạm để bật/tắt. Thanh gợi ý tắt hẳn thì bật ở Tính Năng → Phím & cử chỉ → Chế độ một tay. iOS
Giữ lâu icon con trỏ trên thanh gợi ýBật/tắt chế độ một tay (chỉ điện thoại). Chạm thường = mở bảng sửa văn bản. Android
Giữ phím q w e … pRa số 1 2 3 … 0 (số nhỏ ở góc trên-phải phím). Giữ ~0,4 giây, ô phóng to hiện số, nhấc tay là chèn; chữ vừa chạm tự gỡ, từ đang gõ vẫn đúng dấu. Mặc định bật, chỉ khi tắt Hàng phím số (Tính Năng → Phím & cử chỉ → “Giữ phím hàng trên để ra số”). Không áp dụng khi VoiceOver/TalkBack bật. iPhone Android
Giữ phím a … l, z … mRa ký hiệu in nhỏ ở góc phím: a @ · s # · d $ · f _ · g & · h - · j + · k ( · l ) · z * · x " · c % · v : · b / · n ! · m ?. Mặc định tắt — bật ở Tính Năng → Phím & cử chỉ → “Giữ phím hàng 2, 3 để ra ký tự đặc biệt”. iPhone Android
Giữ lâu phím ,Ra dấu chấm . (chọn Phím cạnh dấu cách → Dấu chấm thì ngược lại: phím ., giữ ra ,) — khi bật một trong hai tuỳ chọn “Giữ phím…” ở trên. Trên Android: hàng dưới bàn chữ là ?123 😊 phím cách , ↵ giống iPhone (không có phím “.” riêng — phím cách rộng hơn; ô địa chỉ web / email vẫn có phím “.”; máy tính bảng có , và . hai bên phím cách). Giữ , mở hàng dấu câu . , ? ! : ; ' " - … với . chọn sẵn — giữ rồi nhả tại chỗ ra ., trượt để chọn dấu khác; chạm nhanh vẫn ra ,. Gõ giọng nói chuyển sang menu giữ 😊. iPhone Android
Vuốt xuống trên phím chữ (iPad)Gõ ký tự phụ in xám phía trên phím, như bàn phím iPad gốc. iPad
Giữ lâu phím 😊Hàng icon: 🌐 đổi bàn phím (chọn sẵn — nhả tại chỗ là mở danh sách bàn phím), 🎤 gõ giọng nói (khi máy có bàn phím giọng nói), ✋ bật/tắt chế độ một tay, 🪟 thả nổi / gắn lại bàn phím, ⚙ mở app ViệtTelex. Trượt chọn rồi nhả; trượt xa để huỷ. Android
Giữ lâu EnterXuống dòng thật trong ô nhiều dòng mà app biến Enter thành “Gửi”. Android

Gõ vuốt Máy học

Bật ở Tính Năng → Gõ vuốt; Luyện vuốt ở cuối trang này. iPhone Android

  • Lướt ngón qua các chữ không dấu của một âm tiết rồi nhấc tay: v→i→e→t ra “việt”.
  • Gõ phím dấu (s f r x j) ngay sau đó để đổi dấu; ⌫ ngay sau đó xoá cả từ vừa vuốt; thanh gợi ý có các cách viết khác.
  • Từ một chữ (ở, ạ, à, ừ, ý…): vuốt theo phím Telex của nó — o→w ra ở, u→w ra ừ, a→j ra ạ, a→f ra à, y→s ra ý. Các dấu khác của cùng chữ (ờ, ơ, ư…) nằm trên thanh gợi ý.
  • Tên riêng tự viết hoa: Hà Nội, Đà Nẵng, Saigon, Singapore, Paris, Google, iPhone…
  • Vuốt từ tiếng Anh (bật sẵn khi bật gõ vuốt): check, mail, file, meeting… Nét vuốt vừa Việt vừa Anh (the/thế, can/cần) ưu tiên tiếng Việt, phương án kia luôn nằm trên thanh gợi ý.
  • Mô hình neural gõ vuốt (tuỳ chọn, mặc định tắt): thêm mạng neural FUTO Swipe chạy hoàn toàn trên máy để chấm cùng bộ giải mã sẵn có — tốn thêm khoảng 3 MB bộ nhớ khi bàn phím mở.
  • Âm thanh nét vuốt (mặc định tắt): tiếng khẽ trong lúc ngón đang vuốt — Bút chì, Chổi lông, Phấn bảng, Bút dạ, Roi vụt, Tia sét, Plasma, Đũa phép, Nốt nhạc theo phím (mỗi phím ngón đi qua gảy một nốt — mỗi từ một giai điệu nhỏ, nhạc cụ theo Âm thanh phím nếu là Piano, Đàn tranh hay Ghi-ta mộc, không thì Đàn tranh), Sáo trúc (cao độ theo vị trí ngón), Sóng biển, Mèo kêu, Chim hót, hoặc Âm của bạn (chọn một file âm thanh, dùng tối đa 3 giây đầu làm vòng lặp, chỉ lưu trên máy); to hơn khi vuốt nhanh, im khi ngón dừng (Roi vụt, Tia sét, Plasma, Đũa phép, Sóng biển, Mèo kêu, Chim hót thêm một tiếng ngắn lúc nhấc tay), theo âm lượng của Âm thanh phím và im khi máy để im lặng. Bút chì miễn phí, các kiểu còn lại thuộc VietTelex Plus. iOS cần Toàn quyền Truy cập.
  • Theo giao diện: khi gõ vuốt đang bật, chọn một giao diện có nét vuốt / âm thanh nét vuốt riêng (Vũ trụ, Halloween, Máy chữ cổ, Sen Việt…) sẽ đổi luôn Hiệu ứng nét vuốt và Âm thanh nét vuốt theo giao diện đó (kiểu thuộc Plus chỉ đổi khi có Plus; nét vuốt đang để Theo giao diện thì giữ nguyên). Đổi tay sau đó thì giữ tới lần chọn giao diện kế. Giao diện JSON: khoá "swipe" và "swipeSound".
  • Tự tắt khi dùng VoiceOver/TalkBack và ở ô mật khẩu, email, địa chỉ web. Trên iOS chỉ có ở iPhone (không có ở iPad).

Gõ tắt

Tính Năng → Gõ tắt & mẫu câu. macOS Cài đặt… → tab Gõ tắt. Windows Cài đặt → tab Gõ tắt. Linux tab Gõ tắt (công tắc Bật gõ tắt).

  • Gõ chữ tắt rồi dấu cách, Enter hoặc dấu câu để bung: ko → không.
  • Gõ chữ tắt rồi dấu cách để bung: ko → không.
  • Hoa/thường theo cách gõ (khi chữ tắt lưu dạng thường): ko → không, Ko → Không, KO → KHÔNG.
  • Chữ tắt có ký hiệu hoặc số (->, k2) bung khi gõ dấu cách.
  • ⌫ ngay sau khi bung = trả lại chữ đã gõ.
  • ⌥↩ để xuống dòng trong nội dung gõ tắt. macOS
  • Không bung khi dính liền sau số hoặc / # @ (5h, /h3), trong ô mật khẩu, email, URL.
  • Dùng Thay thế văn bản của iOS iOS (mặc định bật): các mục trong Cài đặt → Cài đặt chung → Bàn phím → Thay thế văn bản cũng bung như gõ tắt; chỉ đọc (sửa trong Cài đặt iOS), trùng chữ tắt thì bảng VietTelex thắng. Android không có danh sách tương đương cho bộ gõ bên thứ ba.
  • Bảng mặc định rỗng; nút Thêm bộ gợi ý thêm: ko, dc, đc, vs, mn, trc, cty, bsi, stk, -> (→).
  • Nhập/xuất file YAML chữ tắt: nội dung — cùng một định dạng trên Mac, iPhone, Android, Windows và Linux. Nhập còn nhận JSON và văn bản key:value.

Thanh gợi ý & chip

VietTelex không tự sửa chữ của bạn — mọi gợi ý chỉ áp dụng khi bạn chạm. Cài đặt ở Tính Năng → Gợi ý & từ điển. Nút ⌄ ở mép phải thu gọn thanh.

  • Gợi ý từ + tự học từ bạn hay dùng (chỉ lưu trên máy). Từ điển cá nhân: xem, tìm, xoá từ đã học, thêm tên riêng/thuật ngữ. Lọc từ nhạy cảm không chủ động gợi ý từ tục.
  • Số từ gợi ý: chọn thanh gợi ý hiện bao nhiêu từ bằng nút − / + — Tự động (mặc định, 3 từ như trước), hoặc 1 đến 5. Từ đầu tiên là chữ đúng như bạn gõ, rồi tới các gợi ý theo thứ tự hay dùng; 1 từ thì chỉ hiện gợi ý tốt nhất. Màn hình hẹp (hoặc khi thanh có thêm nút emoji/clipboard) có thể hiện ít hơn để mỗi ô đủ rộng cho dễ chạm. Biến thể gõ vuốt vẫn tối đa 3.
  • Nút ẩn bàn phím (mặc định tắt): bật để có nút ⌄ ở góc phải thanh gợi ý — chạm là ẩn bàn phím, khỏi phải chạm ra chỗ khác trong ứng dụng. Nút có cả ở ô mật khẩu; khi tắt Thanh gợi ý thì không có nút (iPad vẫn còn phím ẩn bàn phím ở hàng dưới).
  • Gợi ý sửa lỗi chạm trượt (tab Kiểu Gõ): nbjeeuf → nhiều, ohims → phím — hiện trên thanh, chạm để thay.
  • Gợi ý emoji hợp với từ đang gõ (yêu → ❤️).
  • Chip số: sau khi gõ số — đọc số thành chữ, định dạng tiền (1tr2 → 1.200.000 ₫).
  • Hiện kết quả phép tính: gõ phép tính rồi dấu = (12*3=, 1,5+2=) → kết quả hiện ở đầu thanh gợi ý, chạm để chèn sau dấu =.
  • Nút Dán: vừa copy xong thì thanh gợi ý hiện thẻ Dán. iOS cần Toàn quyền truy cập; để iOS khỏi hỏi mỗi lần: Cài đặt → VietTelex → Dán từ ứng dụng khác → Cho phép.
  • Chip “Thêm dấu” Plus (mặc định tắt): gõ xong một câu không dấu, một chạm thêm dấu cả câu — hom nay troi dep → hôm nay trời đẹp. Bật ở Tính Năng → Gợi ý & từ điển (hoặc ngay trên màn VietTelex Plus); gõ câu không dấu, gõ dấu cách, chip “Thêm dấu” hiện ở đầu thanh gợi ý — chạm để thêm dấu, chạm “Hoàn tác” để trả lại.

Mẫu câu & công cụ văn bản

Bật/tắt ở Tính Năng → Gõ tắt & mẫu câu → Mẫu câu; quản lý ở tab Mẫu Câu.

  • Chạm ☰ trên thanh gợi ý để mở lưới câu soạn sẵn, chạm một câu để chèn. Label ngắn (emoji) giúp lưới gọn hơn.
  • Trong lưới mẫu câu, phím 😊 đổi thành thùng rác — xoá sạch nội dung ô đang gõ.
  • Mẫu câu động: nội dung bắt đầu bằng https:// sẽ tải dữ liệu ngay lúc bấm và chèn kết quả (tối đa 1000 byte) — vd “🌐 IP” chèn địa chỉ IP hiện tại. Có sẵn thêm 💵❓ tỷ giá USD/VND, 💸❓ USD tự do, 🟡❓ giá vàng, 🪙❓ giá BTC (danh sách đã tự chỉnh cũng được thêm một lần; xoá đi thì không thêm lại). iOS cần Toàn quyền truy cập. Không có mạng hoặc máy chủ lỗi thì chèn chính URL.
  • Import/Export YAML - "👋 | Chào buổi sáng"; import là gộp thêm. Android còn có thể chia sẻ chữ từ app khác vào VietTelex để thêm mẫu câu. iOS ô ⚙️ cuối lưới mở thẳng tab Mẫu Câu.
  • Công cụ văn bản Plus: chip Aa đầu lưới mẫu câu — HOA, thường, Hoa Đầu Từ, Hoa đầu câu, Xoá dấu; áp lên phần đang chọn hoặc câu trước con trỏ.

Clipboard & ẩn danh

Tính Năng → Riêng tư & clipboard.

  • Lịch sử clipboard (mặc định tắt): nút 📋 trên thanh gợi ý mở tối đa 20 mục vừa copy — chạm để dán, ghim để giữ lâu. Mục không ghim tự xoá sau 1 giờ — đổi được thành 24 giờ hoặc 7 ngày ở Giữ lịch sử clipboard (Tính Năng › Riêng tư & clipboard). Mục giống mật khẩu/OTP luôn xoá sau 2 phút; mục chỉ nằm trên máy. Bỏ qua ô mật khẩu và nội dung được đánh dấu nhạy cảm. iOS cần Toàn quyền truy cập.
  • Chip tách số Plus: nội dung vừa copy có số tài khoản / SĐT / mã OTP → chip “Dán STK…” chỉ dán đúng phần số. Ghim không giới hạn cũng thuộc Plus.
  • Chế độ ẩn danh: không học từ, không lưu clipboard. Android tự bật trong ô nhập của trình duyệt ẩn danh.

Emoji & kaomoji

  • Phím 😊 mở bàn phím emoji đầy đủ, có nhóm Gần đây 🕐.
  • Tìm emoji bằng tiếng Việt: chạm thanh tìm trên cùng, gõ không dấu cũng được — cuoi → 😀 “mặt cười”. Chạm kết quả để chèn.
  • Tab kaomoji / ký tự đặc biệt (^‿^) ở cuối dãy nhóm emoji.

Giao diện & một tay

Tính Năng → Giao diện (theme, ảnh nền, độ trong suốt, chiều cao hàng, nâng bàn phím, chiều cao thanh gợi ý, logo) và Tính Năng → Phím & cử chỉ (hàng số, giữ phím, dấu cách sau dấu câu, vuốt phím cách, một tay, phóng to chữ, rung).

  • Ngôn ngữ / Language (mục đầu tiên của Tính Năng): giao diện app và chữ trên bàn phím bằng Tiếng Việt (mặc định) hoặc English — đổi là áp dụng ngay.
  • Theme & ảnh nền: Hệ thống, Tối OLED, Tương phản cao luôn miễn phí; các theme khác (Hồng đào, Bạc hà, Trời xanh, Oải hương, Kính, Pixel 8-bit, Biển, AI…) và ảnh nền riêng (chỉnh độ tối lớp phủ, độ mờ) Plus. Ảnh được nén ngay trên máy. Theme Theo giờ đổi màu theo giờ trong ngày như bầu trời thật: bình minh (5–7 giờ), ban ngày, hoàng hôn (17–19 giờ), ban đêm (có sao) — màu được chọn mỗi lần bàn phím hiện lên, không theo chế độ sáng/tối của máy. Theme Neon Night Club: nền đen, phím viền neon; mỗi phím bấm rọi một quầng đèn lên ảnh nền của bạn (ảnh chìm trong tối), chưa có ảnh thì đèn rọi vào nhân vật hoạt hình đang nhảy (cô gái, hoặc chàng trai nếu bạn chọn làm Bạn đồng hành), đổi điệu mỗi lần đèn nháy; kèm hiệu ứng Sàn nhảy LED, âm Nhịp club và quả cầu disco. Theme Gym: nền thép xám có hoạ tiết sàn thép chống trượt, phím cao su tối viền vàng chanh neon; hiệu ứng Rep lấp thanh rep một nấc mỗi phím, đủ 10 phím hiện “SET 1 ✓”, gõ nhanh bật “+1 rep 💪”, gõ “gym”, “tập”, “beast mode”… thì chữ BEAST MODE đập xuống bàn phím; kèm âm Tạ sắt. Theme Bóng đá: sân cỏ sọc, phím trắng như bảng tỉ số; bấm Enter là sút bóng vào lưới ("VÀOOO!"), gõ "vô địch", "Việt Nam vô địch", "VN #1", "vào" hay "goal" thì pháo sáng đỏ và cờ đỏ sao vàng tung lên; bật Âm thanh phím để nghe tiếng bóng và tiếng hò reo. Theme Bể cá: nước sâu, rong và cát, phím kính trong; cá bơi chậm sau hàng phím, mỗi phím thả một viên thức ăn cho chú cá gần nhất bơi tới ăn — cá lớn dần, ăn đủ 500 viên thì có thêm bạn (tối đa 6 con); ngừng gõ vài giây thì bể đứng yên. Theme Cà phê sữa đá: nền chuyển từ cà phê sang sữa, phím như viên đá trong; mỗi phím viên đá lắc nhẹ và đọng giọt nước, phin nhỏ ở góc thanh gợi ý nhỏ giọt cà phê sau vài phím, gõ thật nhanh thì sữa xoáy vào ly; âm "lanh canh" như đá chạm ly.
  • Độ trong suốt phím và Độ trong suốt ký tự (0–100%, miễn phí mọi theme): phím — nền và viền phím (cả nền bàn phím khi không dùng ảnh nền), 100% chỉ còn chữ; ảnh nền luôn giữ nguyên (chỉnh bằng độ tối lớp phủ / độ mờ ảnh); ký tự — chữ và biểu tượng trên phím, 100% là phím trơn không chữ. iOS luôn giữ lớp kính mờ của hệ thống phía sau bàn phím.
  • Tuỳ chỉnh nâng cao Plus (Giao diện, chạm để mở rộng): màu chữ và màu nền phím tự chọn (một màu dùng chung cho sáng lẫn tối, “Theo theme” để trả lại màu theme); độ bo góc phím từ vuông tới tròn hẳn; cỡ chữ trên phím 80–150% (phím hẹp tự thu nhỏ chữ cho vừa, dấu không bị cắt; khi đã đặt, thay cho lựa chọn Vừa/Lớn ở Phím & cử chỉ); phông chữ hệ thống (Mặc định, Tròn, Có chân, Đơn cách, HẹpMặc định, Có chân, Đơn cách, Hẹp) và độ đậm (Mỏng · Thường · Vừa · Đậm · Rất đậm). Hết Plus thì bàn phím về mặc định, lựa chọn vẫn được giữ.
  • Khôi phục giao diện gốc: về theme Hệ thống, tắt ảnh nền (ảnh vẫn giữ để bật lại), độ tối/mờ, độ trong suốt và tuỳ chỉnh nâng cao về mặc định.
  • Giao diện JSON tương tác Plus (Chọn giao diện → ⋯ → Chép JSON / Sửa, hoặc Dán giao diện): JSON giao diện có thêm hai mục chỉ là dữ liệu (không có mã, không chạy chương trình nào):
    • "particles" — hạt bay ra khi bấm phím, dùng khi chọn hiệu ứng Theo giao diện (Hiệu ứng khi bấm phím), hoặc giao diện ghi "effect":"theme" để tự chọn hiệu ứng này khi bạn chọn giao diện. Các khoá (đều tuỳ chọn): glyphs (1–8 ký tự/emoji, mỗi mục đúng một ký tự) hoặc shape (circle, star, heart, square, spark); colors (1–8 màu #RRGGBB); count 1–12 hạt mỗi lần bấm; spread 0–360° (góc xoè); direction (0 = lên, 90 = phải, 180 = xuống); speed 20–600; gravity −800…800 (dương kéo xuống); lifeMs 200–2500 mili-giây; size 8–48; sizeJitter 0–100%; spin −720…720 độ/giây; fade out | inOut; origin key (phím vừa bấm) | bottom | top. Số ngoài khoảng được đưa về khoảng cho phép (có cảnh báo); chỉ dùng số nguyên.
    • "keywords" — tối đa 20 mục {"words":[…], "burst":{…}, "text":"…"}: gõ xong một từ trong words (1–8 từ, mỗi từ chỉ gồm chữ, tối đa hai từ như "năm mới") là nổ chùm burst (cùng các khoá như particles; thiếu thì dùng particles của giao diện, không có nữa thì nổ tim) và chữ text (≤ 16 ký tự) bay lên. Không phân biệt hoa thường; dấu có nghĩa — "yêu" không khớp yeu, muốn khớp cả hai thì ghi cả hai. Chạy thêm cùng mọi hiệu ứng đang chọn (kể cả “Không”).
    Ví dụ “Mưa mì” (mì rơi từ mép trên bàn phím):
    {"v":1, "name":{"vi":"Mưa mì","en":"Noodle rain"},
     "light":{"key":"#FFF8EE","special":"#F3D9B1","ink":"#4A2A10","accent":"#E0702B"},
     "effect":"theme",
     "particles":{"glyphs":["🍜","🥢"], "count":5, "origin":"top", "direction":180,
                  "spread":40, "speed":60, "gravity":300, "lifeMs":1600, "size":22, "spin":90}}
    Ví dụ “Gõ chữ yêu nổ tim”:
    {"v":1, "name":{"vi":"Nổ tim","en":"Heart burst"},
     "light":{"key":"#FFF5F9","special":"#F6B8CE","ink":"#5A1F38","accent":"#D94680"},
     "keywords":[{"words":["yêu","thương","love"],
                  "burst":{"glyphs":["❤️","💖"], "count":10, "spread":360, "speed":140, "gravity":-40},
                  "text":"❤️ ❤️ ❤️"}]}
    Pháo sáng nhỏ từ phím (dán vào JSON của giao diện bất kỳ, rồi chọn hiệu ứng Theo giao diện):
    "particles":{"shape":"star", "colors":["#FFD54F","#FF8A65"], "count":6,
                 "spread":70, "speed":180, "gravity":420, "lifeMs":900, "sizeJitter":40, "fade":"inOut"}
    Hạt và chữ luôn nằm trong bàn phím, mỗi lần bấm tối đa 12 hạt; tự tắt khi bật Chế độ nguồn điện thấp / Trình tiết kiệm pin. “Chép JSON” và sao lưu giữ nguyên hai mục này.
  • Chiều cao hàng phím ±10 pt mỗi hàng (Android: −10 … +18 dp; trên +10, màn hình thấp hoặc xoay ngang tự giới hạn để bàn phím không quá nửa màn hình) (Giao diện). Trên iPhone, mức 0 = như bàn phím iPhone: phím, khe và vị trí đúng như bàn phím gốc theo cỡ máy (máy lớn như Pro Max/Plus/Air phím cao hơn); tăng/giảm là cao/thấp hơn bàn phím gốc bấy nhiêu pt mỗi hàng. Bản cập nhật tự đổi mức cũ sang thang mới để bàn phím của bạn giữ gần như cũ.
  • Nâng bàn phím (Giao diện, 0–48, bước 4): thêm khoảng trống dưới hàng phím cuối — cả bàn phím nằm cao hơn, ngón cái dễ với hơn. Mặc định tắt.
  • Chiều cao thanh gợi ý (Giao diện, cạnh Chiều cao hàng phím): Thấp / Vừa (mặc định) / Cao. Thanh cao hơn thì ô gợi ý to hơn, khó chạm nhầm; bàn phím cao thêm đúng phần đó, hàng phím giữ nguyên. iPhone: Thấp 30 pt (như bản cũ), Vừa 36, Cao 44; khi xoay ngang, Cao dùng như Vừa để bàn phím không chiếm quá nhiều màn hình. Android: Thấp 35 dp, Vừa 42 (như bản cũ), Cao 51; khi xoay ngang, Cao dùng như Vừa. Thu gọn thanh (⌄) vẫn như cũ.
  • Logo Vᴛ mờ trên phím cách (Giao diện); Hàng phím số 1…0 trên hàng chữ (Phím & cử chỉ). Mặc định phím số thấp hơn phím chữ một chút; bật Hàng số cao bằng hàng chữ (ngay dưới) để phím số to bằng phím chữ.
  • Phím cạnh dấu cách (Phím & cử chỉ, chỉ iPhone): phím hẹp bên phải phím cách trên bàn chữ là Dấu phẩy (mặc định), Dấu chấm (cùng chỗ, cùng cỡ — giữ phím ra dấu phẩy, hàng dấu câu có , chọn sẵn), Cả hai (, bên trái và . bên phải phím cách, mỗi phím hẹp như trên, phím cách ngắn lại; giữ , vẫn ra dấu câu khác) hoặc Tắt (không có phím, phím cách rộng hơn; chạm đúp phím cách vẫn ra “. ”). Máy tính bảng: phím cách nằm giữa hàng, , bên trái và . bên phải — Dấu phẩy, Dấu chấm hay Cả hai đều giữ cả hai phím; Tắt bỏ cả hai cho phím cách rộng hơn. Ô email / địa chỉ web, iPad và bàn số / ký hiệu giữ nguyên.
  • Nút emoji (Phím & cử chỉ): Hàng dưới (mặc định — phím 😊 cạnh ?123) hoặc Thanh trên: bỏ 😊 khỏi hàng dưới bàn chữ (phím cách rộng hơn), nút 😊 lên thanh gợi ý (sát trái nút thu gọn ⌄, luôn hiện kể cả khi đang có gợi ý hay thanh thu gọn; giữ nút ra cùng menu như giữ phím 😊: đổi bàn phím, gõ giọng nói, một tay, thả nổi, cài đặt) (bên trái 📋 / ⌄; khi thanh thu gọn thì nổi cạnh ⌄; chỉ iPhone — iPad giữ nguyên). Khi thanh gợi ý không hiện (tắt Thanh gợi ý, ô mật khẩu…) nút vẫn ở hàng dưới để luôn mở được emoji.
  • Cỡ chữ trên phím (Phím & cử chỉ, Android): Vừa (mặc định) hoặc Lớn — chữ, số, dấu câu to hơn khoảng 22%, nhãn và biểu tượng phím chức năng to hơn khoảng 12%; phím hẹp (một tay, máy nhỏ) tự thu chữ cho vừa phím. Kết hợp với Chiều cao hàng phím nếu muốn phím to hơn nữa.
  • Giữ phím hàng trên để ra số (hiện khi tắt Hàng phím số) và Giữ phím hàng 2, 3 để ra ký tự đặc biệt — xem Cử chỉ ẩn.
  • Tự thêm dấu cách sau dấu câu (Phím & cử chỉ, mặc định tắt): gõ . , ? ! ; : tự có dấu cách phía sau. Không thêm trong số (3.5, 1,000), email, đường dẫn và ô email/web/số/mật khẩu. Gõ dấu cách ngay sau không thành hai dấu cách; ⌫ ngay sau chỉ xoá dấu cách đó; gõ ngoặc/nháy đóng thì dấu cách dời ra sau (hi.)␣).
  • Vuốt phím cách đổi Tiếng Việt / Tiếng Anh (Kiểu Gõ → Gõ mixed Việt/Anh, mặc định tắt): vuốt nhanh phím cách sang trái/phải; khi bật, góc dưới-phải phím cách hiện VI / EN mờ như bàn phím gốc (thay logo Vᴛ).
  • Phóng to chữ khi bấm, Rung phím (iOS cần Toàn quyền truy cập). Phím sẫm khi bấm: phím đổi màu trong lúc chạm, kể cả khi tắt phóng to chữ.
  • Âm thanh phím (Phím & cử chỉ, mặc định tắt): tiếng phím riêng của VietTelex (chữ / xoá / phím chức năng kêu khác nhau) với thanh Âm lượng 0–100%; bật lên sẽ hiện hàng Âm thanh gõ mở trang chọn kiểu: iOSHệ thống (tiếng bấm phím của hệ thống, không cần Toàn quyền truy cập), Nhẹ nhàng (mặc định khi bật, trầm êm), Gõ gỗ, Bàn phím cơ, Máy chữ, Bong bóng, Đá, Pop, Nước, Cổ điển, Pháo, Chuông, Piano (mỗi phím một nốt ngũ cung, hàng dưới trầm hàng trên cao; mỗi lần cách là hợp âm đệm kế tiếp theo vòng C → Am → F → G, nghỉ gõ quá 3 giây hoặc hết câu (. ! ?) thì quay lại hợp âm đầu; Enter là hợp âm kết; Shift/Caps Lock là pedal ngân, bấm nhiều phím cùng lúc thành hợp âm), Đàn tranh (như Piano nhưng theo ngũ cung điệu Bắc, tiếng dây gảy có nhấn nhá; cách/Enter là tiếng rải dây, Shift là vuốt dây), Ghi-ta mộc (như Piano, tiếng dây sắt; mỗi lần cách quạt 6 dây theo vòng Am → F → C → G, Enter quạt hợp âm kết Đô trưởng rồi quay lại đầu vòng, ⌫ là tiếng chặn dây) — hoặc Âm của bạn (chọn một file âm thanh ngắn; tự cắt lặng đầu, giữ tối đa 0,3 giây, chỉnh độ to an toàn; file chỉ nằm trên máy, không có trong sao lưu). Kéo thanh Âm lượng / Độ mạnh rung là nghe/rung thử ngay; chạm một kiểu là nghe thử phím chữ → xoá → phím chức năng; không kêu đôi với tiếng hệ thống, không ngắt nhạc đang nghe, im khi máy để im lặng hoặc rung. Tắt thì dùng tiếng bấm phím của hệ thống như cũ. iOS cần Toàn quyền truy cập (thiếu thì vẫn là tiếng của iOS).
  • Chế độ một tay (điện thoại): Tắt / Trái / Phải — thu hẹp bàn phím về một bên; nút ở dải trống để đổi bên hoặc thoát. Bật nhanh bằng cử chỉ ở mục Cử chỉ ẩn.
  • Bàn phím thả nổi Android: tách bàn phím khỏi đáy thành khung nhỏ; kéo thanh dưới cùng để đặt đâu cũng được, app bên dưới vẫn dùng được (không bị co). Bật ở Phím & cử chỉ hoặc giữ 😊 → 🪟; nút ⤓ trên thanh kéo để gắn lại. Vị trí nhớ riêng dọc / ngang; khi nổi, một tay và Nâng bàn phím tạm bỏ qua.
  • Bàn phím thả nổi: không có trên iPhone / iPad — iOS không cho bàn phím của bên thứ ba thả nổi (trên iPad, chụm hai ngón để thả nổi chỉ áp dụng cho bàn phím của Apple). Trên iPhone dùng Chế độ một tay; trên iPad và màn hình rộng dùng Bàn phím tách đôi (Tính Năng → Giao diện). iOS
  • Chọn phím thông minh Thử nghiệm (Tính Năng → Chính tả & sửa lỗi, mặc định bật): chạm sát mép giữa hai phím thì chọn phím hợp với chữ đang gõ; chạm giữa phím luôn ra đúng phím đó, chữ đã gõ không bao giờ bị tự sửa.
  • Tự sửa từ gõ sai Thử nghiệm (Tính Năng → Chính tả & sửa lỗi, mặc định tắt): khi gõ dấu cách, nếu chữ vừa gõ không phải từ hợp lệ và điểm chạm lệch hẳn sang phím bên cạnh thì sửa thành từ phổ biến (tpoi → tôi). Chỉ sửa khi chắc chắn; không đụng từ tiếng Anh, từ bạn hay dùng, ô mật khẩu/email/web. ⌫ ngay sau đó (hoặc chạm ô ↩︎ chữ gốc trên thanh gợi ý) để trả lại chữ gốc — từ đó sẽ không bị sửa nữa.

Riêng Android Android

  • Bảng sửa văn bản: chạm icon con trỏ trên thanh gợi ý — mũi tên, đầu/cuối dòng, chọn / chọn từ / chọn hết, sao chép / cắt / dán, hoàn tác / làm lại; cuối bảng có hàng công cụ văn bản Plus.
  • Telex cho bàn phím cứng (Tính Năng → Phím & cử chỉ → Bàn phím cứng): gõ Telex/VNI bằng bàn phím Bluetooth/USB, Samsung DeX, Chromebook; phím tắt Ctrl/Alt vẫn tới app.
  • Ô số / số điện thoại / ngày giờ tự mở bàn số riêng.

Sao lưu & đồng bộ

Tính Năng → Sao lưu & đồng bộ.

  • Xuất / Nhập file sao lưu: cài đặt, gõ tắt, mẫu câu (và từ đã học nếu bật “Kèm từ đã học”) — một file mở được trên iPhone, iPad và Android. Nhập: cài đặt theo file, gõ tắt và mẫu câu được gộp thêm.
  • Đồng bộ iCloud iOS Plus: cài đặt, gõ tắt và từ đã học theo bạn sang máy khác cùng Apple ID.
  • Đồng bộ iCloud macOS: Cài đặt… → Tùy chỉnh → Đồng bộ cài đặt gõ và gõ tắt với iPhone/iPad (cần đăng nhập iCloud).
  • Android còn tự sao lưu cài đặt vào Google (Sao lưu của hệ thống) khi bạn bật.

Trên macOS macOS

Menu Vᴛ trên thanh menu

  • Cơ chế gõ: … của app đang dùng — bấm để mở tab Ứng dụng và chép thông tin gỡ lỗi (dán vào báo lỗi).
  • Công cụ văn bản (bật ở Tùy chỉnh → “Hiện công cụ văn bản trong menu VietTelex”): bôi đen chữ ở app bất kỳ rồi mở menu VietTelex → Công cụ… (bảng nhỏ hiện cạnh con trỏ; bấm nút hoặc phím 1–6, Esc để đóng) — Thêm dấu cho vùng chọn (toi di hoc → tôi đi học), HOA, thường, Hoa Đầu Từ, Hoa đầu câu, Xoá dấu.
  • Kết quả phép tính (bật sẵn; tắt ở Tùy chỉnh → “Hiện kết quả phép tính”): gõ phép tính rồi = (12*3=, 200+10%=) — gợi ý “= 36” hiện ngay dưới con trỏ (ô ứng viên của macOS, hoặc ô nhỏ “⇥ Tab” ở terminal/trình duyệt), bấm Tab hoặc Enter để chèn kết quả; Esc hoặc phím khác thì tắt.
  • Chip số (bật sẵn; tắt ở Tùy chỉnh → “Chip số”): gõ số tiền có k/tr/tỷ rồi dấu cách (50k, 1tr2, 2 tỷ) — gợi ý dạng tiền “1.200.000 ₫” hiện dưới con trỏ, bấm Tab để thay; phím khác thì tắt.
  • Gợi ý sửa lỗi gõ sai (bật sẵn; tắt ở Tùy chỉnh → “Gợi ý sửa lỗi gõ sai”): gõ nhầm phím bên cạnh hay đảo hai phím (tpoi, khpong) rồi dấu cách / dấu phẩy — từ đúng (tôi, không) hiện dưới con trỏ, chỉ khi rất chắc; bấm Tab để thay (giữ dấu cách/dấu câu). Không bao giờ tự sửa; từ tiếng Anh, từ chat, từ đúng thì để yên. Esc: thôi gợi ý từ đó.
  • Gợi ý thêm dấu cho câu không dấu (tắt sẵn; bật ở Tùy chỉnh): gõ từ 3 âm tiết không dấu trở lên (toi di hoc) rồi . ! ?, hoặc dừng tay chừng một giây sau dấu cách — câu có dấu (tôi đi học) hiện dưới con trỏ, bấm Tab để thay cả cụm. Không kích hoạt ở Enter (Enter có thể đã gửi tin); gõ tiếp là huỷ.
  • Gợi ý ngày giờ (bật sẵn; tắt ở Tùy chỉnh → “Gợi ý ngày giờ”): gõ hôm nay, ngày mai, hôm qua rồi dấu cách ⇒ gợi ý ngày (28/09/2026); bây giờ ⇒ giờ (21:35); âm lịch, ngày âm hoặc ÂL ⇒ ngày âm lịch hôm nay (30/9 năm Bính Ngọ); Tết ⇒ ngày mùng 1 Tết sắp tới (Tab giữ chữ: Tết 06/02/2027); sau một từ tiếng Anh cũng nhận today, tomorrow, yesterday, now. Bấm Tab để thay cụm chữ bằng ngày giờ; muốn giữ chữ thì gõ tiếp hoặc Esc.
  • Cài đặt… mở cửa sổ cài đặt; Cài đặt hệ thống… mở Bàn phím → Nguồn đầu vào.

Phím tắt

  • Chuyển Việt/Anh: 🌐 hoặc ⌃Space của macOS; nút Cài đặt hotkey… mở Phím tắt → Nguồn đầu vào để đổi.
  • Phím tắt chuyển bộ gõ Thử nghiệm (tab Thử nghiệm): bấm-nhả riêng ⌃⇧, ⌥⇧ hoặc ⌘⇧ để chuyển giữa VietTelex và bộ gõ trước đó — tổ hợp chỉ-phím-bổ-trợ mà macOS không cho gán. Không kích hoạt nếu bạn gõ phím hay bấm chuột khi đang giữ. Cần quyền Trợ năng.
  • Phím tắt Thêm dấu (mặc định tắt): ⌃⌥T, ⌃⇧T hoặc ⌥⌘T — thêm dấu cho chữ đang bôi đen ở mọi app, kể cả khi đang dùng bộ gõ khác. Cần quyền Trợ năng (chép vùng chọn rồi dán kết quả; clipboard được trả lại).

App gõ sai? Tab Ứng dụng

  • Tab Ứng dụng: VietTelex tự học cách gõ cho từng app; bạn có thể tự chọn — Phím thật (không gạch chân, cần Trợ năng), Gạch chân (luôn hiện đúng), Sửa thẳng trong ô, Tắt tiếng Việt (ở app đó)… Có nút xoá dữ liệu đã học (giữ lựa chọn tay). Nhập/xuất YAML.
  • Chi tiết từng app: Chế độ gõ trong ViệtTelex.
  • Cho người viết app/script — tín hiệu “kết thúc từ”: ở cách gõ Phím thật, VietTelex thấy mọi phím nên chữ cái mà app terminal dùng làm lệnh (j/k/i…) bị tính là đầu một từ. Gửi com.viettelex.endWord lúc vào chế độ nhập chữ (hoặc sau khi script đổi focus) để kết thúc từ đang gõ, như một phím cách không gõ ra gì: notifyutil -p com.viettelex.endWord trong shell, notify_post("com.viettelex.endWord") trong C, hoặc DistributedNotificationCenter.default().postNotificationName(.init("com.viettelex.endWord"), object: nil) trong Swift. Tín hiệu không mang dữ liệu, không đọc hay sửa chữ, không đổi cài đặt. Tín hiệu là bất đồng bộ: gửi xong hãy để phím kế tiếp đi sau (post cách nhau dưới 50 ms được gộp làm một); tắt được ở Cài đặt → Chung → Nâng cao / Gỡ lỗi.
  • Giữ VietTelex khi macOS tự đổi bộ gõ (Cài đặt… → Gõ phím → Chuyển Việt/Anh → Nâng cao): một số app (bình luận trong Word…) làm macOS trả về bộ gõ mặc định ở mỗi ô mới; tuỳ chọn này chuyển lại VietTelex — chỉ khi không phải do bạn đổi.
  • Phát tiếng khi đổi Việt/Anh (tắt sẵn; cùng chỗ, mục Nâng cao): tiếng đi lên là VietTelex, đi xuống là bộ gõ khác. Không kêu khi macOS tự đổi theo app vừa chuyển hoặc ở ô mật khẩu.

Khác

  • Biểu tượng trên thanh menu (tab Thử nghiệm): Vᴛ, ★ hoặc 🇻🇳 — cần khởi động lại máy để thấy.
  • Cập nhật: nút Kiểm tra cập nhật, hoặc “Tự kiểm tra hàng tuần và báo khi có bản mới”.
  • Ghi nhật ký gỡ lỗi (tab Thử nghiệm) chỉ ghi sự kiện, không bao giờ ghi chữ bạn gõ; bấm chép rồi dán vào báo lỗi.
  • App tải từ App Store (Slack, WhatsApp…) không nhận VietTelex hoặc thoát đột ngột khi đổi bộ gõ: thoát hẳn app đó rồi mở lại. VietTelex tự làm mới danh sách bộ gõ mà macOS lưu riêng cho app đó.
  • Gỡ cài đặt VietTelex… ở tab Giới thiệu (xoá app, cài đặt và gõ tắt). Cài bằng Homebrew thì brew uninstall --cask viettelex.

Trên Windows Windows

Chuyển Việt/Anh

  • Biểu tượng khay (mặc định bật với người dùng mới): V = tiếng Việt, E = tiếng Anh, theo app đang dùng. Bấm trái = đổi Việt/Anh; bấm đúp = mở Cài đặt; bấm phải = menu (Công cụ văn bản, Cài đặt, Thoát VietTelex…). Biểu tượng mờ = đang chọn bàn phím khác, bấm để bật lại VietTelex.
  • Tab Kiểu gõ → Phím chuyển Việt/Anh: CtrlShift (mặc định — bấm rồi nhả, không gõ phím nào khác), AltZ, WinSpace (đổi bộ gõ của Windows, VietTelex ↔ ENG) hoặc Tắt.
  • Thoát VietTelex ở khay = tắt bộ gõ: Windows quay về bàn phím bạn dùng trước đó (hoặc tiếng Anh). Mở lại VietTelex từ menu Start là bật lại.
  • Chuyển bằng CtrlShift / AltZ: VietTelex nhớ Việt/Anh riêng cho từng ứng dụng.
  • Chuyển bằng WinSpace: nhớ theo app hay không là tuỳ chọn “Cho phép dùng bộ gõ khác nhau cho từng cửa sổ ứng dụng” của Windows — Cài đặt VietTelex hiện trạng thái và có nút bật.

Không gạch chân, gõ được mọi nơi

  • Mặc định VietTelex sửa chữ trực tiếp trong ô nhập — không gạch chân từ đang gõ.
  • Terminal (Command Prompt, PowerShell, Windows Terminal, PuTTY…) và app Qt/Java/Adobe (Telegram, JetBrains…) được gõ trực tiếp, không gạch chân (xoá rồi gõ lại chữ có dấu) khi VietTelex đang chạy.
  • Ô mật khẩu, PIN, số, số điện thoại, email: gõ nguyên phím, không bỏ dấu.
  • Tab Ứng dụng — chỉ đổi khi một app gõ sai: nhập tên tệp chạy (vd notepad.exe) rồi chọn Mặc định (sửa trực tiếp), Composition, Trực tiếp (gõ trực tiếp, không gạch chân), Dự phòng (hook bàn phím) hoặc Luôn tiếng Anh. “Dự phòng” cần VietTelex đang chạy.

Công cụ văn bản

  • Bôi đen chữ ở app bất kỳ rồi bấm chuột phải biểu tượng VietTelex ở khay → Công cụ văn bản: Thêm dấu cho vùng chọn (toi di hoc → tôi đi học), HOA, thường, Hoa Đầu Từ, Hoa đầu câu, Xoá dấu. Cần bật Hiện biểu tượng ở khay hệ thống; ẩn menu này ở tab Chính tả → Hiện công cụ văn bản trong menu.
  • Phím tắt Thêm dấu (tab Chính tả, mặc định tắt): CtrlAltT, CtrlShiftT hoặc WinAltT — thêm dấu cho chữ đang bôi đen ở mọi app, kể cả khi đang dùng bộ gõ khác.
  • VietTelex đọc và thay vùng chọn thẳng qua bộ gõ khi app hỗ trợ; nơi không đọc được (app Qt/Java cũ, hoặc khi đang dùng bàn phím khác) thì chép vùng chọn rồi dán kết quả — clipboard của bạn được trả lại. Không chạy trong ô mật khẩu, terminal, app điều khiển từ xa và app chạy quyền quản trị.

Biểu tượng, cập nhật, khác

  • Biểu tượng bàn phím (thanh tác vụ và danh sách WinSpace): Vᴛ, Ngôi sao, Cờ Việt Nam, Logo hoặc Chữ VI — đổi cần quyền quản trị.
  • Hiện biểu tượng ở khay hệ thống (bật sẵn cho người dùng mới; người dùng cũ giữ lựa chọn đã lưu): chữ V/E của app đang dùng, mờ khi VietTelex đang tắt.
  • Mở app không hiện cửa sổ Cài đặt (tắt sẵn): mở VietTelex thì chỉ chạy nền ở khay; mở lần nữa khi đang chạy để hiện Cài đặt.
  • Phát tiếng khi đổi Việt/Anh (tắt sẵn; Kiểu gõ → Chuyển Việt/Anh → Nâng cao): tiếng đi lên là tiếng Việt, đi xuống là tiếng Anh. Chỉ kêu khi bạn tự đổi (phím tắt, bấm biểu tượng khay), không kêu khi VietTelex đổi theo app.
  • Ngôn ngữ / Language của cửa sổ cài đặt và menu khay: Tiếng Việt (mặc định, dù Windows đặt ngôn ngữ nào) hoặc English — đổi là áp dụng ngay.
  • Cập nhật: bấm Kiểm tra ngay, hoặc bật tự kiểm tra (mỗi ngày một lần). Bản tải về phải có chữ ký hợp lệ mới được cài.
  • Ghi nhật ký gỡ lỗi: ghi sự kiện vào %LOCALAPPDATA%\VietTelex\debug.log, không ghi nội dung bạn gõ.
  • Gỡ cài đặt… trong Cài đặt VietTelex, hoặc Cài đặt Windows → Ứng dụng.

Trên Linux Linux

Chuyển Việt/Anh

  • Mặc định CtrlSpace; đổi ở tab Tuỳ chỉnh → Phím chuyển Việt/Anh (cần ít nhất một phím Ctrl/Alt/Shift/Super; không dùng được SuperSpace vì GNOME đã dùng; Backspace = tắt phím chuyển).
  • Nhớ Việt/Anh theo từng app và App mới mở bắt đầu bằng tiếng Việt (đều mặc định bật); nút Quên tất cả xoá trạng thái đã nhớ. Ubuntu 22.04 + IBus không báo app nào đang gõ nên nhớ chung cho mọi app (trừ GNOME Wayland).
  • Phát tiếng khi đổi Việt/Anh (tắt sẵn): tiếng đi lên là tiếng Việt, đi xuống là tiếng Anh, chỉ khi bạn tự đổi (phím chuyển, menu bộ gõ). Cần một trong các lệnh pw-play, paplay, aplay (bản phân phối nào cũng có sẵn một cái).

Hiển thị chữ đang gõ

  • Cách hiện từ đang gõ: Chữ đang gõ (preedit) — mặc định, chạy ở mọi app — hoặc Sửa trực tiếp (surrounding), tự quay về preedit ở app không hỗ trợ.
  • Gạch chân chữ đang gõ mặc định tắt. Chrome/Electron và app Wayland trên GNOME luôn tự gạch chân — không tắt được.
  • Terminal: gõ thẳng, sửa dấu bằng Backspace (mặc định bật) ở terminal GTK3/Qt; terminal khác dùng preedit.
  • Tab Ứng dụng: chọn theo app — Tự động, Gạch chân chữ đang gõ, Sửa thẳng trong ô, Gõ thẳng, sửa bằng Backspace hoặc Tắt tiếng Việt. Nhập/xuất YAML.
  • Remote desktop, máy ảo và Wine mặc định tắt tiếng Việt (gõ ở máy bên kia); muốn gõ thì thêm app đó vào tab Ứng dụng.

Công cụ văn bản

  • Bôi đen chữ ở app bất kỳ rồi mở menu bộ gõ (biểu tượng VietTelex trên khay / thanh trên cùng) → Công cụ… — Thêm dấu cho vùng chọn (toi di hoc → tôi đi học), HOA, thường, Hoa Đầu Từ, Hoa đầu câu, Xoá dấu. Giống bản macOS.
  • Bật/tắt ở tab Tuỳ chỉnh → Hiện công cụ văn bản trong menu (mặc định bật); Phím tắt Thêm dấu mặc định tắt — chọn một tổ hợp có Ctrl/Alt/Super.
  • Cần gói viettelex-text-tools (apt tự cài kèm). App không báo chữ quanh con trỏ cho bộ gõ thì VietTelex đọc vùng đang bôi đen (PRIMARY); với IBus cần wl-clipboard hoặc xclip đã cài sẵn. Clipboard không bị đụng tới. Không chạy ở ô mật khẩu và terminal.

Ngôn ngữ & biểu tượng

  • Tab Tuỳ chỉnh → Ngôn ngữ / Language: Tiếng Việt (mặc định, kể cả khi máy cài tiếng Anh) hoặc English — áp dụng ngay cho app cài đặt và menu bộ gõ.
  • Biểu tượng khay giống thanh menu macOS: Vᴛ khi gõ tiếng Việt, E khi chuyển sang tiếng Anh. GNOME hiện chữ VT / E.

Tương thích & khác

  • Tab Tương thích chỉ liệt kê lưu ý khớp với máy bạn, kèm nút chép lệnh sửa — vd Chrome/Electron trên Wayland cần --enable-wayland-ime. Danh sách đầy đủ: linux/README.
  • Ô mật khẩu sudo trong terminal không nhận ra được — chuyển sang tiếng Anh trước khi gõ mật khẩu.
  • Cài đặt lưu ở ~/.config/viettelex/config.toml và shortcuts.yml.
  • Cập nhật: sudo apt upgrade (kho APT), hoặc nút Kiểm tra cập nhật ở tab Giới thiệu.

Quyền, riêng tư & Plus

  • iOS: bàn phím dùng đầy đủ khi không cấp Toàn quyền truy cập. Chỉ cần quyền này cho: Rung phím, Âm thanh phím, Mẫu câu động (https://), nút Dán, Lịch sử clipboard và lưu từ đã học. VietTelex không thu thập, không gửi nội dung bạn gõ.
  • Android: quyền mạng chỉ dùng cho Mẫu câu động do bạn tạo. VietTelex không thu thập, không gửi nội dung bạn gõ.
  • macOS: quyền Trợ năng (macOS 27: Điều khiển thiết bị và truy cập dữ liệu) cần cho gõ trong Terminal/Chrome (cách gõ Phím thật), phím tắt chuyển bộ gõ và phím tắt Thêm dấu. Không thu thập dữ liệu.
  • Windows: không thu thập dữ liệu; chỉ kết nối mạng khi bạn bấm Kiểm tra cập nhật hoặc bật tự kiểm tra.
  • Linux: không thu thập dữ liệu; chỉ kết nối mạng khi bạn bấm Kiểm tra cập nhật.
  • VietTelex Plus (mua một lần): theme cao cấp & ảnh nền, thêm dấu cả câu, clipboard nâng cao, đồng bộ iCloud, công cụ văn bản, huy hiệu cảm ơn. Toàn bộ phần gõ luôn miễn phí. Trên iOS từ bản 1.2 Plus là gói mua một lần (69.000đ); Android hiện vẫn mở miễn phí. Cách dùng từng tính năng (cũng ghi ngay trên màn Plus):
    • Thêm dấu cả câu: bật chip “Thêm dấu” (Tính Năng → Gợi ý & từ điển, hoặc công tắc trên màn Plus; mua/khôi phục xong app sẽ hỏi bật). Gõ không dấu cả câu, gõ dấu cách, chạm chip “Thêm dấu” ở đầu thanh gợi ý.
    • Theme cao cấp & ảnh nền: Tính Năng → Giao diện.
    • Clipboard nâng cao: bật Lịch sử clipboard (Tính Năng → Riêng tư & clipboard), chạm nút clipboard trên thanh gợi ý; vừa copy STK/SĐT/OTP → chip “Dán …” hiện trên thanh gợi ý.
    • Công cụ văn bản: chạm ☰ trên thanh gợi ý → chip “⚒️ Công cụ” đầu lưới mẫu câu (Android: cả hàng cuối bảng sửa văn bản).
    • Đồng bộ iCloud: Tính Năng → Sao lưu & đồng bộ → bật Đồng bộ iCloud.
  • Bản máy tính miễn phí và mã nguồn mở (MIT).

Gặp lỗi hoặc muốn góp ý? Báo trên GitHub · Mới học gõ? Học gõ Telex.