Download ViệtTelex

After installing

1. Settings → General → Keyboard → Keyboards → Add New Keyboard… → VietTelex.
2. While typing, tap 🌐 to switch to VietTelex. Try it in the app: vieejt → việt.
3. Optional: turn on Allow Full Access for haptics, VietTelex's own key sounds, the Paste button and clipboard history. Typing Vietnamese doesn't need it.

Full iPhone/iPad guide →

Installing the APK

1. Open the downloaded .apk; if asked, allow your browser to install unknown apps.
2. Open the VietTelex app → Enable VietTelex (Settings → System → Languages & input → On-screen keyboard), then Choose VietTelex.
3. The “may be able to collect all the text you type” warning is Android's generic notice for every third-party keyboard — VietTelex runs entirely on your device.

The Google Play version will update itself; update the APK by installing a newer one over it. All Android releases · Full guide →

Other ways

Install through one channel only (.pkg or Homebrew) — both manage ~/Library/Input Methods/VietTelex.app.

After installing

1. System Settings → Keyboard → Input Sources → Edit… → ＋ → Vietnamese → ViệtTelex → Add (the installer opens this for you).
2. To type in Terminal/iTerm/Chrome: grant Accessibility — Privacy & Security → Accessibility → tick VietTelex.
3. Switch Vietnamese/English with 🌐 or ⌃Space. Settings: the Vᴛ icon in the menu bar → Settings….

Full macOS guide →

Downloading the .msi: which one?

Microsoft Store picks the right build for you. For the .msi: x64 for Intel/AMD PCs (most). ARM64 for Snapdragon/ARM PCs. Not sure: Settings → System → About → System type.

After installing

1. Click Get in Microsoft Store (or run the .msi); VietTelex's Settings window opens when it's done.
2. Pick VietTelex with Win+Space. Not listed? Open VietTelex once from the Start menu.
3. Upgrading: Microsoft Store updates it automatically; with the .msi, install the new version over the old one, or click Check for updates in the app.

Full Windows guide →

Fcitx5 or IBus?

Fcitx5 (recommended, the installer's default): smoother, fewer glitches in Chrome/Electron/terminals; the first time you need to log out and back in once. IBus is Ubuntu/GNOME's default — use --ibus to keep it.

Other ways

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   # or: sudo apt install viettelex-ibus

After installing

1. Open VietTelex from the app menu (or run viettelex-settings --onboarding) and follow the guide.
2. Fcitx5: log out and back in once, then click Add. IBus (GNOME): Settings → Keyboard → Input Sources → + → Vietnamese → VietTelex.
3. Switch Vietnamese/English: Ctrl+Space.

Full Linux guide →

Attach to a text field

No bundler needed — load it straight from the 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() to detach
</script>

With a bundler: import { attach } from '@viettelex/core'. Ctrl+Space toggles Vietnamese/English; password/email/number/tel fields stay literal; the SDK steps aside when the device already has a Vietnamese input method (UniKey, EVKey, the OS IME…). Custom editors, canvas, games: use createEngine().

Pick a build

Every build adds the SDK's JS (~5.9 KB gzip). Lite drops the English dictionaries: it keeps Telex/VNI, the syllable validator and rule-based auto-restore (google, github) and differs only on dictionary words (he is → “he í”). Separate .wasm builds let a CDN/browser cache the engine long-term.