License Code

⚠️ This information is irrelevant with Setapp and App Store builds. If you are using Permute via Setapp or the App Store, the following does not apply.

When you purchase Permute, you receive a license code that is in the following format: XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX. When you first install Permute, it will prompt you to enter the license code. As each license code comes with a limit how many times it can be used (default is 3), it is advisable to deactivate the license code prior to moving to a new computer and discarding/reinstalling the old one. To do so, select Permute > Deactivate License Code... in the menu bar.

Under some circumstances, you might want to automate this - e.g. if you switch between computers on regular basis, or if you want to deploy Permute across multiple computers. Starting with Permute v3.8.2, you can automate both activation and deactivation of the license code via command line.

Activation

open 'permute-license://activate?email=my@email.com&license=XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX'

This will try to activate the license code XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX under the email address my@email.com. Both license and email query items are required.

Note: If the app is already activated, then this command will be ignored.

Installing License Code for All Users

If you have multiple users on your computer and want to install the license code so that all of them are activated, create a folder com.charliemonroe.Permute-3 in /Users/Shared/. Permute will then use this folder for license code storage and it will be used across all users on that computer.

Note: Due to the nature of this, the license code is automatically hidden from the UI (see below).

Deactivation

open 'permute-license://deactivate?email=my@email.com&license=XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX'

This will try to deactivate the license code XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX under the email address my@email.com. Both license and email query items are required.

Note: If the app is already deactivated, then this command will be ignored. The command will also be ignored if the license passed in the command does not match the one that’s used in the app. This is to prevent malicious license code deactivation.

Hiding License Code from UI

If the computer on which you are installing Permute is publicly accessible (in a school, library, etc.), it is advisable to hide the license code from the UI to prevent it being shared by other users. By default, when you select Permute > Show License Code... in the menu bar, it will be displayed - this is so that you can retrieve it when necessary, but it also has the downside of being accessible to anyone.

There are two ways to hide the license code from the UI:

This will cause the license code to be obfuscated in the UI and all log files.