Every app
Messaging, the browser, chat apps: VnKey works in any text field. Shift, automatic capitals and the Fn keys behave as they always do.
VnKey brings Telex, the typing method of Unikey, to Symbian. Press plain letters on the QWERTY keyboard and Vietnamese appears in Messaging, the browser, chat apps and every other text field.
Features
Everything you expect from Telex on a computer, working inside the phone's own apps, with the phone's own keyboard.
Messaging, the browser, chat apps: VnKey works in any text field. Shift, automatic capitals and the Fn keys behave as they always do.
Ctrl+Space switches between Vietnamese and English. A small [V] or [E] sits in the bottom bar by the clock and steps aside in full-screen games and video. Other keys can be set in triggers.txt.
With spell check on, a word that cannot be Vietnamese gets its keys back as you finish it: tẽt becomes text, ưindow becomes window.
ko → không, dc → được, vn → Việt Nam, in the case you typed them. Add your own to macros.txt on the memory card.
Traditional (hòa, thúy, khỏe) or modern (hoà, thuý, khoẻ). The tone moves as the word grows: hòa, then n, gives hoàn.
VnKey starts with the phone and turns Telex back on by itself. Its settings screen is in Vietnamese or English, and every letter is precomposed Unicode.
How it works
VnKey adds a small input plugin that the phone loads into each app. The phone's own input method stays in charge of the keys; VnKey only fixes up the word.
Telex
Type the letter, then the key that adds its mark or tone. The order is forgiving: marks and tones can also come at the end of the word.
| Letters | ||
|---|---|---|
| aa | â | |
| aw | ă | |
| ee | ê | |
| oo | ô | |
| ow | ơ | |
| uw | ư | or w alone |
| dd | đ | |
| Tones | ||
|---|---|---|
| s | á | sắc |
| f | à | huyền |
| r | ả | hỏi |
| x | ã | ngã |
| j | ạ | nặng |
| z | a | no tone |
| Whole words | ||
|---|---|---|
| toans | toán | tone last |
| vietej | việt | mark last |
| nguoiwf | người | one w for ươ |
| hoafn | hoàn | tone moves |
| ass | as | twice to undo |
| thuowr | thuở | at the word's end |
Every example on this page, the typing demo included, was produced by VnKey's own Telex engine.
Install
One package, installed like any other Symbian app.
vnkey-x.y.z.sisx from Releases, in the phone's browser or on a computer and then onto the phone.off in E:\VnKey\ (File manager can) and the plugin leaves every app alone.E:\VnKey\vnkey.log, and sends nothing anywhere. Password fields are never logged.Build
The build runs in a public Docker image with the S60 3rd Edition FP2 SDK, GnuPoc and GCCE, so a Mac, Linux or Windows (WSL) machine with Docker is all it takes.
GitHub Actions runs the same build on every push. The packages on the Releases page come from it, built from the tagged commit.
# the Telex engine's tests, with the host's compiler
$ bash symbian/test/run.sh
# the package: symbian/sis/vnkey.sisx
$ bash symbian/group/docker-build.sh