Skip to content
ZKeyVietnamese input for macOS
EN
Get ZKey

ZKey

Release notes

What changed in each version of ZKey.

Version history

ZKey, version by version

Newest first. Upgrade by installing the new installer over the old one — your settings and custom words are kept.

  1. 1.0

    build 1ReleaseLatest

    First release

    • Developer ID signed and notarized by Apple — macOS opens the installer normally, no need to turn off Gatekeeper.
    • One universal installer for Apple silicon and Intel Macs.
    • Checks for a new version once a day; when there is one, the input menu and ZKey Settings → Cập nhật show a download button. Can be turned off in Settings.
    • The installer now walks you through adding the keyboard, with screenshots.
    • Requires macOS 13 Ventura or later.

  2. 0.2.19

    build 23Fixes

    A tidier VI icon

    • The “VI” menu-bar icon uses a 22×16 frame like the U.S. keyboard badge.
    • 8.5 pt lettering, no longer larger than the system icons.

  3. 0.2.18

    build 22Fixes

    Steady typing in Chrome, VS Code and Slack

    • Fixed lost letters and a cursor that seemed stuck at the start of the word in Chrome, Electron (VS Code, Slack) and WebKit.
    • A mouse click (left, right or middle) commits the word being typed.
    • When an app cancels the input range, ZKey drops that word's buffer.

  4. 0.2.13 – 0.2.17

    Fixes

    Input range and cursor

    • A lone marked vowel is kept on commit: uwx → ữ.
    • Several cursor-position fixes, including after emoji.
    • Diagnostic logging (only with ZKEY_TRACE_COMPOSITION=1) records key counts, never the text.

  5. 0.2.9

    build 12Change

    The input method ships on its own

    • The input method lives at /Library/Input Methods/ZKeyInputMethod.app, so macOS registers it reliably.
    • Existing preferences are carried over automatically.

  6. 0.2.5

    New

    Telex habits, understood

    • Shorthand: giw → giư, giwx → giữ.
    • An e after the final consonant: chuyene → chuyên, chuyener → chuyển.
    • A circumflex after a vowel cluster: nhieue → nhiêu.
    • An a after ua: luanaj → luận.

  7. 0.2.2

    Fixes

    English stays English

    • database no longer becomes “dât”.
    • Strings that are not valid syllables go back to their keys while you type, without waiting for Space.

  8. 0.2.1

    Fixes

    ZKey shows up in Keyboard settings

    • Fixed the input method's identifier so macOS lists ZKey under Vietnamese input sources.
    • The installer reports clearly if registering the input source fails.

Ready?

Install ZKey in two minutes

Download the installer, run it, then pick ZKey in the menu bar. The guide has a screenshot for every step.

Download ZKey for macOSVersion 1.0 · macOS 13+ · Apple Silicon & Intel