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.
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.
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.
brew install --cask ptrinh/viettelex/viettelex. Đừng cài song song hai kênh.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?
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õ.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.
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.
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.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
.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.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).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.
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ố.w đứng lẻ giữ nguyên là w, không thành ư.cc → ch, nn → ng, tt → th…th[ → thơ. Nếu gõ code nên để tắt. macOS Windows Linuxlisst → list). macOS Windows LinuxQuê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ỏ.
tháy ␣ ⌫ a → thấy.s f r x j: viêt + j → việt; chao + f → chào (VNI: số 1–5, 0).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éo | Biế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 tay | Sao 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ách | Chọ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ách | Ra “. ” (dấu chấm + cách) sau chữ/số. iOS Android |
| Chạm . , ? ! ) " ' : ; ở bàn số / ký hiệu | Tự 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 bung | Trả 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 … p | Ra 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 … m | Ra 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 Enter | Xuống dòng thật trong ô nhiều dòng mà app biến Enter thành “Gửi”. Android |
Bật ở Tính Năng → Gõ vuốt; Luyện vuốt ở cuối trang này. iPhone Android
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."swipe" và "swipeSound".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).
ko → không.ko → không.ko → không, Ko → Không, KO → KHÔNG.->, k2) bung khi gõ dấu cách./ # @ (5h, /h3), trong ô mật khẩu, email, URL.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.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.
nbjeeuf → nhiều, ohims → phím — hiện trên thanh, chạm để thay.1tr2 → 1.200.000 ₫).= (12*3=, 1,5+2=) → kết quả hiện ở đầu thanh gợi ý, chạm để chèn sau dấ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.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.
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.- "👋 | 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.Tính Năng → Riêng tư & clipboard.
cuoi → 😀 “mặt cười”. Chạm kết quả để chèn.(^‿^) ở cuối dãy nhóm emoji.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).
"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":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.. , ? ! ; : 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.)␣).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.Tính Năng → Sao lưu & đồng bộ.
toi di hoc → tôi đi học), HOA, thường, Hoa Đầu Từ, Hoa đầu câu, Xoá dấu.= (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.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.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ừ đó.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ỷ.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.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.brew uninstall --cask viettelex.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.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.%LOCALAPPDATA%\VietTelex\debug.log, không ghi nội dung bạn gõ.pw-play, paplay, aplay (bản phân phối nào cũng có sẵn một cái).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.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.VT / E.--enable-wayland-ime. Danh sách đầy đủ: linux/README.sudo trong terminal không nhận ra được — chuyển sang tiếng Anh trước khi gõ mật khẩu.~/.config/viettelex/config.toml và shortcuts.yml.sudo apt upgrade (kho APT), hoặc nút Kiểm tra cập nhật ở tab Giới thiệu.Gặp lỗi hoặc muốn góp ý? Báo trên GitHub · Mới học gõ? Học gõ Telex.