Skip to content

Repository files navigation

Typio is an English IME for non-native speakers on macOS.

It is designed for people who write in English daily but still lose flow on spelling, word choice, or constant input method switching.

Typio is especially useful for Korean, Japanese, and Chinese users who want an English-first typing experience instead of full Chinese IME behavior.

Everything is local-first: no cloud dependency, no sign-in flow, and no extra distractions. You type, Typio suggests practical candidates, and you keep writing.

Typio means the end of typo.

Why Typio

  • ✍️ Stay in flow: keep typing while candidates update in place.
  • 🧠 Practical suggestions: focused on high-frequency English usage.
  • 🧩 Flexible panel styles: horizontal, grid (multi-row), and vertical layouts.
  • 🔒 Private by default: all input processing stays local.

Screenshots

Demo

Input Source Menu Language Mode Switch
Typio input source menu Typio language toggle
Multi-row Candidate Panel Settings: Panel Style
Typio candidate grid Typio settings panel style

Install

For end users, download and run Typio-<version>.pkg, then enable Typio in System Settings → Keyboard → Input Sources.

Allow applications from App Store & Known Developers      Open typio-1.0.pkg anyway

Typio 1.1.2 restores the original single input source and uses a circular icon with a T cutout in both the menu bar and inline switcher. The system adjusts the icon color for appearance and selection. The input-mode configuration introduced in 1.1.1 has been removed after a later restart exposed switching problems.

When updating from 1.1.1, remove the old Typio entry and add Typio again in Input Sources. If the old entry or icon persists, log out and back in or restart macOS.

Build and Package

Use bash scripts/build.sh to build the app, bash scripts/build-and-install.sh for local developer install, and bash scripts/package-pkg.sh to generate the installer package at dist/Typio-<version>.pkg.

If you need installer signing, set INSTALLER_SIGN_IDENTITY before packaging.

Support Typio

Typio is built for the community. If you find it helpful, please consider supporting its development on my personal blog.

About

Project home: https://github.com/howtoexitvim/Typio

License and credits

Typio is a modified version of HallelujahIM by Dong Yuwei and contributors, released under GNU GPL v3. Typio modifications by Shuqi Wang, 2026, include the local-only engine, native settings, candidate panel layouts, branding, input-source icons, and installation flow.

See THIRD_PARTY_NOTICES.md for dependency licenses and dictionary provenance, and BUILDING.md for building from source.

About

Typio is an English IEM for non-native speakers on macOS.

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages