Tải ViệtTelex

Sau khi cài

1. Cài đặt → Cài đặt chung → Bàn phím → Bàn phím → Thêm bàn phím mới… → VietTelex.
2. Khi gõ, bấm 🌐 để chuyển sang VietTelex. Thử trong app: vieejt → việt.
3. Tuỳ chọn: bật Cho phép truy cập đầy đủ (Full Access) nếu muốn dùng rung phản hồi, âm phím riêng, nút Dán và lịch sử clipboard. Gõ tiếng Việt không cần quyền này.

Hướng dẫn chi tiết cho iPhone/iPad →

Cài bằng APK

1. Mở file .apk vừa tải; nếu máy hỏi, cho phép trình duyệt cài ứng dụng không rõ nguồn gốc.
2. Mở app VietTelex → bấm Bật VietTelex (Cài đặt → Hệ thống → Ngôn ngữ & nhập liệu → Bàn phím trên màn hình), rồi Chọn VietTelex.
3. 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.

Bản trên Google Play sẽ tự cập nhật; bản APK cập nhật bằng cách tải bản mới và cài đè. Mọi bản Android · Hướng dẫn chi tiết →

Cách khác

Chỉ cài qua một kênh (.pkg hoặc Homebrew) — cả hai cùng quản lý ~/Library/Input Methods/VietTelex.app.

Sau khi cài

1. System Settings → Keyboard → Input Sources → Edit… → ＋ → Vietnamese → ViệtTelex → Add (trình cài tự mở sẵn trang này).
2. Để gõ trong Terminal/iTerm/Chrome: bật quyền Trợ năng — Privacy & Security → Accessibility → tick VietTelex.
3. Chuyển Việt/Anh bằng 🌐 hoặc ⌃Space. Cài đặt: biểu tượng Vᴛ trên thanh menu → Cài đặt….

Hướng dẫn chi tiết cho macOS →

Tải .msi: chọn bản nào?

Microsoft Store tự chọn đúng bản. Nếu tải .msi: x64 cho máy Intel/AMD (đa số). ARM64 cho máy Snapdragon/ARM. Không chắc: Cài đặt → Hệ thống → Giới thiệu → Loại hệ thống.

Sau khi cài

1. Bấm Tải trong Microsoft Store (hoặc chạy file .msi); cửa sổ Cài đặt của VietTelex tự mở.
2. Chọn VietTelex bằng Win+Space. Không thấy? Mở VietTelex một lần từ menu Start.
3. Nâng cấp: Microsoft Store tự cập nhật; bản .msi thì cài bản mới đè lên, hoặc bấm Kiểm tra cập nhật trong app.

Hướng dẫn chi tiết cho Windows →

Fcitx5 hay IBus?

Fcitx5 (khuyên dùng, mặc định của lệnh cài): gõ mượt hơn, ít lỗi hơn trong Chrome/Electron/terminal; lần đầu cần đăng xuất/đăng nhập một lần. IBus là mặc định của Ubuntu/GNOME — chọn --ibus nếu muốn giữ nguyên.

Cách khác

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

Sau khi cài

1. Mở VietTelex trong menu ứng dụng (hoặc viettelex-settings --onboarding) và làm theo hướng dẫn.
2. Fcitx5: đăng nhập lại một lần rồi bấm Thêm. IBus (GNOME): Cài đặt → Bàn phím → Nguồn nhập → + → Tiếng Việt → VietTelex.
3. Chuyển Việt/Anh: Ctrl+Space.

Hướng dẫn chi tiết cho Linux →

Gắn vào ô nhập

Không cần bundler — nạp thẳng từ CDN:

<textarea id="note"></textarea>
<script type="module">
  import { attach } from 'https://cdn.jsdelivr.net/npm/@viettelex/core@1/dist/viettelex.mjs';
  const vt = await attach(document.getElementById('note'));
  // vt.setEnabled(false) · vt.setOptions({ inputMethod: 'vni' }) · vt() để gỡ
</script>

Có bundler: import { attach } from '@viettelex/core'. Ctrl+Space chuyển Việt/Anh; ô password/email/number/tel luôn gõ thường; SDK tự nhường khi máy đã có bộ gõ tiếng Việt khác (UniKey, EVKey, bộ gõ hệ thống…). Editor riêng, canvas, game: dùng createEngine().

Chọn bản

Mọi bản cộng thêm phần JS của SDK (~5,9 KB gzip). Bản lite bỏ từ điển tiếng Anh: vẫn đủ Telex/VNI, kiểm tra âm tiết và tự khôi phục theo luật (google, github), chỉ khác ở từ cần từ điển (he is → “he í”). Bản .wasm riêng để CDN/trình duyệt cache lâu dài.