Skip to main content

Getting Started

Keywrite provides pre-made input methods for various Ethiopic languages. These follow the mnemonic principles outlined in the GFF Ethiopic Keyboard Specification: http://keyboards.ethiopic.org/specification/

Ethiopic script is an ancient writing system used by multiple languages in the Horn of Africa, primarily in Ethiopia and Eritrea. The script is syllabic, meaning each character (called a syllograph) represents a consonant-vowel combination rather than individual letters.

Available Input Methods

The following input methods correspond to the specifications defined in the GFF Ethiopic Keyboard Specification:

Input MethodNameSupported Regions
am-ETAmharicam-ET
awn-ET_byn-ER_xan-ETAwngi, Blin, Xamtangaawn-ET, byn-ER, xan-ET
bcq-ETBenchbcq-ET
mym-ET_muz-ET_suq-ET_mdx-ETDizi, Me'en, Mursi, Surimym-ET, muz-ET, suq-ET, mdx-ET
gez-ET_gez-ERGe'ezgez-ET, gez-ER
har-ETHararihar-ET
sgw-ETSebatbeitsgw-ET
xst-ETSilt'exst-ET
ti-ERTigrinya (Eritrean)ti-ER
ti-ETTigrinya (Ethiopia)ti-ET
ETEthiopic (Language Neutral)ET

Installation

yarn install @keywrite/ethiopic-input-methods

Ethiopic Input Method Principles

The Ethiopic input methods follow these key principles:

1. Phonological Continuity

Letters map between scripts based on phonetic correspondence:

  • s (both 's' sound)
  • m (both 'm' sound)

2. Character Class Continuity

  • Letters map to letters
  • Numbers map to numbers
  • Punctuation maps to punctuation

3. Ergonomic Design

Frequently occurring characters require fewer keystrokes:

  • e (common, single key)
  • ee (less common, double key)