TranslateKit

Automatic localization for your Shortcut.


Description

TranslateKit is a fast, lightweight way to auto-localize your shortcut (multilingual support). Your shortcut can be understood in almost any language using TranslateKit.

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

LanguageMenu

TranslateKit automatically detects the system language of the user and puts it at the top of the language selection menu. However, user can select any language in the menu regardless of their system language.

How to use in your shortcut

Getting started with TranslateKit is as easy as 4 actions.

Example Usage

Run TranslateKit at the start of your shortcut, before it put a Dictionary action with a shortcut_name, and shortcut_id key (Your RoutineHub ID). This will prompt the user to select a language to use for your shortcut.

The Run Shortcut action will output the language they select. Keep in mind it will be in their system language.

Duplicate those actions in your workflow but include a text key with a dictionary type value. Fill this dictionary with text you'll use across your shortcuts dialogues and menus. When run, it returns a dictionary with the same keys translated to whichever language your user selected.

Further step-by-step guide: https://translatekit.com/page/documentation

Dictionary Guide

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.

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 affect 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 standard localizations except you don’t have to create them!

Download Badge

If you'd like, you can include the code below on your RoutineHub page to let your users know to download TranslateKit if they don’t already have it.

[![Requires TranslateKit](https://i.imgur.com/H8RJgxY.png)](https://routinehub.co/shortcut/2691)

Requires TranslateKit

Example use 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.

Step-by-step guide: https://translatekit.com/page/documentation


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.


Dependencies: UpdateKit

Powered by Microsoft Translate

Created with ScPL

Graphics created with MediaKit


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.

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

Latest Release Notes

2.1.0 - Sept. 23, 2019, 5:17 p.m.

-Change language selections within TranslateKit
-Reduced actions, now even faster


Past versions