Skip to content

Latest commit

 

History

History
176 lines (130 loc) · 7.8 KB

README.md

File metadata and controls

176 lines (130 loc) · 7.8 KB

Translit

macOS License Tests

This macOS keyboard input source allows a user familiar only with Latin alphabet keyboard to type in other languages by using common Latin transliteration of the target language letters. Currently supported target languages are Hebrew and Russian. To give an example, typing privet in Russian mode will produce привет and typing hi in Hebrew mode will produce הי.

Features

  • Type normally in any window without copy/pasting from a separate app/browser

  • Supports multiple languages: currently Russian and Hebrew with an easy way to add more if desired.

  • Supports modern macOS versions

  • Distributed as signed and notarized installer - you don't need to build it yourself (but you can if you want to).

  • Reliable installation and uninstallation on recent versions of macOS.
    Starting roughly with macOS Ventura, Apple has introduced various bugs into its keyboard input sources architecture that make adding and removing them unreliable, error prone and require log off. The installer and uninstaller for this application makes the whole process reliable and simple for the user.

  • Not using punctuation like ' or # for transliteration.
    When typing normally on macOS (as opposed to some designated transliteration app) switching between input modes is more complicated - you cannot just press ESC like translit.ru does. This makes typing text with lots of punctuation annoying. Additionally hijacking ' interferes with macOS "smart quotes" if you use this feature. Avoiding punctuation, such as using q for ь and qq for ъ makes typing much smoother.

    There are existing macOS transliteration projects on Github such as cyrillic-transliterator and its forks but none of them supports all the features above.

Installation

  • Navigate to Releases page and download Translit-x.y.pkg package installer.
  • Run it and install the app
  • You will be prompted to log off at the end of the installation. This is unfortunately necessary. Apple provides no way to avoid this.
  • After you log back in launch System Preferences ⇒ Keyboard
  • In the Text Input section press Edit... button for Input Sources


  • Press the + button to add an input source


  • Navigate to Russian or Hebrew language and select Russian Translit or Hebrew Translit as desired. If you wish to use both press the + again after adding one.

You are all set. If you have enabled Show Input menu in menu bar setting

you should see something like this in it

Select the newly added input method and you can start typing in it anywhere.

Keyboard shortcuts

By default macOS sets ⌃Space and ⌃⌥Space to switch between different input sources. Which is far more convenient when typing than using the menu bar.

If these aren't working navigate to System Preferences ⇒ Keyboard ⇒ Keyboard Shortcuts ⇒ Input Sources and enable or change them.

Viewing transliteration mappings

When a transliteration input mode is selected the pop-up system menu will show addition entries like these

Select Show Mappings to display which Latin characters and combination map to which letters of the target language.

Uninstallation

To completely uninstall Translit issue the following commands in Terminal

  • If you installed Translit only for yourself
~/Library/Input\ Methods/Translit.app/Contents/MacOS/Translit --uninstall
  • If you installed Translit for all users
/Library/Input\ Methods/Translit.app/Contents/MacOS/Translit --uninstall

You can also see the exact command for your installation in About Translit menu with a translit mode selected.

Just like with installation, you will be prompted for a logoff at the end. This, unfortunately, is also necessary due to Apple's bugs.

Mappings

The character mappings for Russian and Hebrew are given in the following tables

Russian

АаБбВвГг ДдЕеЁёЖж
AaBbVvGg DdEeJo
Yo
Ö
Ë
jo
yo
ö
ë
Zhzh
ЗзИиЙйКк ЛлМмНнОо
ZzIiJjKk LlMmNnOo
ПпРрСсТт УуФфХхЦц
PpRrSsTt UuFfH
X
h
x
Cc
ЧчШшЩщЪъЫы ЬьЭэЮюЯя
ChchShshW
Shh
w
shh
QQqqYy QqJe
Ä
je
ä
Ju
Yu
Ü
ju
yu
ü
Ja
Ya
ja
ya

Hebrew

אבגדהוזח טיכךלמם
abgdho
u
zx Ti
j
kKlmM
נןסעפף צץקרשת
nNsyf
p
F
P
cCqrwt

Building

Xcode 15 or above and Python 3 are the only requirements to build Translit.

  • Download/clone the repo
  • Run fetch script from the top-level directory (current directory doesn't matter). This will fetch external dependencies
  • Open Translit.workspace and build the Translit or Installer scheme