TranslateKit

Automatic localization for your iOS Shortcut.

Download on RoutineHub

Complete support for iOS 13 is coming soon. I am aware of the issues with resetting TranslateKit and clearing language selections for individual shortcuts in iOS 13 and will be fixing them soon.

How to Implement TranslateKit into your Shortcut

Last updated June 15, 2019


Future Note: As far as I know this still works on iOS 13, only the look of the actions has changed. You need to tap "See More" on some actions as well, that will be added to this documentation in the future where needed.

First, make sure you've downloaded TranslateKit and added it to your Shortcuts library. You can download it here.

The first step, like with all dependencies, is to check to make sure the user of your Shortcut has TranslateKit added to their library.

First, lets focus on the Otherwise. If they don't have TranslateKit, use a Show Alert action letting the user know this Shortcut requires TranslateKit and they need to add it to their library.

Use a URL action with the Open URLs action following it to open translatekit.com where they can download TranslateKit. Allow a cancel button on the alert so the user is not forced to navigate to the URL.

If they do have TranslateKit, use a Dictionary action with your 'shortcut_name' and 'shortcut_id'. On the first run, this will prompt the user to select a language for your Shortcut. Afterwords, first run or not, Run Shortcut will return the language the user has selected, if you'd like to confirm it. Keep in mind it will be returned in the users system language.

Here is a complete reference of the keys and values you can use in the Dictionary action.

* Indicates required key

Key Type Value
shortcut_name * Text Name of your Shortcut
shortcut_id * Number Your Shortcuts RoutineHub ID
text Text or Dictionary Standard text or dictionary to translate
url URL iCloud file URL (e.g. 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.

Then, after the End If, place another Dictionary, this time with the same keys, but a new key 'text'. Set the type as a dictionary.

PROTIP: Tap on the icon on the previous dictionary and press 'Add to this Shortcut' to duplicate the dictionary in your Shortcut.

You'll notice it says '0 items' in your Dictionary, tap on that and a dictionary editor will appear. Enter keys and values to use for menu items, prompts, dialogues, etc.

Now, this step is important. Use a Get Variable action and select the Run Shortcut magic variable.

Tap on the variable. A menu will appear, tap on 'as Text', and select 'Dictionary'. After it, use Set Variable, set the name of this as whatever you want, or just name it 'KitDict', 'TranslateKit', etc. This is the variable you will use to access the translated dictionary TranslateKit returns.

That's it! You're on your way to fully integrating TranslateKit into your Shortcut.

If you not quite understanding, or are having issues, download the example Shortcut. If you noticed a bug, please contact me.


© 2019 TranslateKit