Repository files navigation

This macOS keyboardinput source allows a user familiar only with Latin alphabet keyboard totype 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, typingprivet in Russian mode will produceпривет and typinghi in Hebrew mode will produceהי.

• Features
• Installation
  • Keyboard shortcuts
  • Viewing transliteration mappings
  • Uninstallation
• Mappings
  • Russian
  • Hebrew
• Building

• 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 architecturethat make adding and removing them unreliable, error prone and require log off. The installer and uninstaller for thisapplication 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 somedesignated transliteration app) switching between input modes is more complicated - you cannot just pressESC liketranslit.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 usingq forьandqq forъ makes typing much smoother.

  There are existing macOS transliteration projects on Github such ascyrillic-transliteratorand its forks but none of them supports all the features above.

• Navigate toReleases page and downloadTranslit-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 providesno way to avoid this.
• After you log back in launchSystem Preferences ⇒ Keyboard
• In theText Input section pressEdit... button forInput Sources
  
  
  
• Press the+ button to add an input source
  
  
  
• Navigate toRussian orHebrew language and selectRussian Translit orHebrew Translit as desired. If you wishto use both press the+ again after adding one.

You are all set. If you have enabledShow 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.

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 toSystem Preferences ⇒ Keyboard ⇒ Keyboard Shortcuts ⇒ Input Sources and enable or change them.

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

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

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 inAbout 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 dueto Apple's bugs.

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

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

• Download/clone the repo
• Runfetch script from the top-level directory (current directory doesn't matter). This will fetch external dependencies
• OpenTranslit.workspace and build theTranslit orInstaller scheme