Moving from XKey to KeyVi

KeyVi cannot read XKey's export files yet. For now, bring your macros over with the plain text template, then choose your typing method, tone style and the apps to ignore again in KeyVi. Importing XKey's export files directly (macros and those settings) is planned, once the file format has been checked against a real export.

Get your macros out of XKey

1. Open XKey's settings from its menu bar icon and find the macro list. VERIFY The section name.
2. If XKey can export the macro list, save the file to the Desktop and open it in TextEdit to copy its contents. VERIFY Whether there is an export button, and the file format.
3. Copy each row (shortcut, expansion) into a text file using the plain text template, saved as UTF-8.
4. Note the typing method, tone style and excluded apps you use in XKey. Choose the typing method and tone style again in KeyVi's Settings, Typing; for each app to exclude, use Ignore this app in the KeyVi menu.

Screenshots will be added once each step has been checked on a real install VERIFY

Import into KeyVi

1. Open KeyVi, go to Settings > Macros > Import from file... (or choose Choose file... at the import step during setup).
2. Read the preview: counts of new, duplicate and invalid rows. For duplicates, choose to keep yours or use the imported one.
3. Invalid rows are skipped with a reason; one bad row never ruins the whole import.

Quit XKey and stop it from opening at login

Two input methods at once make letters double or vanish. Quit XKey and stop it from starting at login.

1. Click the XKey icon in the menu bar and choose quit. VERIFY The menu item name in the current version.
2. Open System Settings > General > Login Items & Extensions. In the Open at Login list, select XKey and press the minus (-) button. VERIFY The item names on each macOS version.
3. If XKey has its own start-at-login option in its settings, turn that off too. VERIFY