TranslateKit

Bring multilingual support to your Shortcut.


Description

A development tool for easily adding multilingual support to your shortcut.

Easy to implement translator

Translate basic text or entire dictionaries into the language your user's select to make your shortcut understood in almost any language.

Built-in languages menu with country flags and translated language names.

Mockup
Image does not show a complete list of all of the languages TranslateKit offers. A complete list exists on this page.

Usage

Run TranslateKit at the start of your shortcut, before it put a dictionary action with shortcut_name, shortcut_id. This will prompt the user to select a language to use for your shortcut.

Wherever you need text translated, run TranslateKit within your shortcut again but with the dictionary: shortcut_name, shortcut_id, text. It will return back the text but translated to whichever language your users select.

Key Type Value
shortcut_name (Required) Text Name of your Shortcut
shortcut_id (Required) Number Your shortcuts RoutineHub ID
text Text or Dictionary Standard text or dictionary to translate
url URL iCloud file URL such as ‘your_shortcut/localization.json’. Method for inputting JSON from a url instead of a dictionary value.
progress Boolean Whether or not to show an alert before translating letting the user of your shortcut know that translating your shortcut may take a moment.

You can put a dictionary value for the text key instead to translate multiple fields, returning a translated dictionary with the same keys. Use this method to translate an entire shortcut.

After translating the dictionary, the dictionary data is saved in iCloud as /translatekit/{your_shortcut_id}/translation.json.

Translations are cached for quick retrieval so that if the text has not changed, it won’t effect the speed of your shortcut. If the original text is in the selected language, it is passed back immediately.

After the first run and cache, it’s just as fast as using localizations except you don’t have to create them!

Full documentation on implementing TranslateKit into your shortcuts: https://translatekit.com/page/documentation

Supported Languages
Afrikaans
Arabic
Bangla
Bosnian
Bulgarian
Cantonese (Traditional)
Catalan
Chinese Simplified
Chinese Traditional
Croatian
Czech
Danish
Dutch
English
Estonian
Fijian
Philippines
Finnish
French
German
Greek
Haitian Creole
Hebrew
Hindi
Hmong Daw
Hungarian
Icelandic
Indonesian
Italian
Japanese
Swahili
Korean
Latvian
Lithuanian
Malagasy
Maltese
Norwegian
Persian
Polish
Portuguese
Querétaro Otomi
Romanian
Russian
Samoan
Serbian (Cyrillic)
Serbian (Latin)
Slovak
Slovenian
Spanish
Swedish
Tahitian
Tamil
Telugu
Thai
Tongan
Turkish
Ukrainian
Urdu
Vietnamese
Welsh
Yucatec Maya

Includes easy to understand example shortcut

Examples

Download Example "How-to" Shortcut on RoutineHub

Includes download for an example shortcut with instruction comments on how to build translations into your menus, alerts, etc. and how to allow your users to clear their language selection within your shortcut.


Offline Support: TranslateKit requires a stable internet connection to translate text/dictionaries or get cached translations from iCloud. Translation speed or cache retrieval can be slow as a result of a poor internet connection. The original text is returned when offline.

Localization Support: TranslateKit detects the system language to translate its internal menus and dialogues. It doesn’t use any services like Mail, Calendars or location services like other shortcuts might to detect the system language.

Language Support: TranslateKit uses a translator API by Microsoft via a shortcut action to translate text and dictionaries. The languages available are based on what the translator supports.

Dependencies: UpdateKit

Powered by Microsoft Translate

Created with ScPL

Graphics created with MediaKit


Latest Release Notes

2.0.5 - June 22, 2019, 3:59 p.m.

Your detected language now shows up at the top of the languages menu!


All release notes