Source of truth: layouts/armenian-phonetic.toml.
The Mac .keylayout, the iPhone key grid and the picture on the website are all generated from it by tools/build.py.
Most people in Armenia learned to type on Windows, so the letters follow the Windows Armenian Phonetic layout (KBDARMPH) exactly. Anyone who types Armenian on Windows can type on this layout without relearning anything.
| Row | Keys → letters |
|---|---|
| Number row | ` ՝ · 1 է · 2 թ · 3 փ · 4 ձ · 5 ջ · 6 ւ · 7 և · 8 ր · 9 չ · 0 ճ · - - · = ժ |
| Top row | q ք · w ո · e ե · r ռ · t տ · y ը · u ւ · i ի · o օ · p պ · [ խ · ] ծ · \ շ |
| Home row | a ա · s ս · d դ · f ֆ · g գ · h հ · j յ · k կ · l լ · ; ; · ‘ ՛ |
| Bottom row | z զ · x ղ · c ց · v վ · b բ · n ն · m մ · , , · . ։ · / / |
Shift gives the capital letter.
| Layout | Where | How it differs |
|---|---|---|
| Windows Armenian Phonetic | Built into Windows | The convention we follow for letters. Digits need AltGr; ։ is on Shift+; and « » only exist on the extra ISO key, which US-style keyboards don’t have. |
| Apple “Armenian – HM QWERTY” | Built into macOS | Different letter places (q ճ, w ւ, o ո, j ձ, x խ, c ծ), 13 letters only on Option; ։ ՝ ՞ « » և all behind Option. |
| Apple “Armenian – Western QWERTY” | Built into macOS | Western Armenian; letter places differ a lot. |
| Community “Armenian Phonetic” (Ukelele) | Mac downloads | Same as Windows but with r ր / 8 ռ swapped in one variant. |
We keep r = ռ, 8 = ր as on Windows. Swapping them is a one-line change in the source file if that turns out to be what people want.
| Mark | Name | Key | Windows | Apple HM |
|---|---|---|---|---|
| ։ | verjaket (full stop) | . | Shift+; | Option+. |
| , | comma | , | , | , |
| ՝ | but (comma-like pause) | **** | |
Option+, | |
| ՛ | emphasis | ‘ | ’ | Option+’ |
| ՞ | question | Shift+/ | Shift+/ | Option+/ |
| ՜ | exclamation | **Shift+** | Shift+ |
Option+1 | |
| « » | quotes | Shift+, Shift+. | ISO key only | Option+9 / 0 |
| և | yev ligature | 7 | 7 | Option+V |
| — | dash | Shift+- | Shift+- | Option+Shift+- |
Hold Option and every key types exactly what it types on the US English keyboard: Option+1 is 1, Option+Shift+1 is !, Option+A is a. Keyboard shortcuts (⌘C, ⌘V …) work as usual.
Copy layouts/armenian-phonetic.toml to, for example, layouts/russian-phonetic.toml,
change the id, name and keys, and run python3 tools/build.py. The Mac bundle and the
iPhone keyboard pick it up automatically.