Permute · Help
Jump to
Migrating to a New Computer Automation and Remote Deployment Remote Activation Installing License Code for All Users Remote Deactivation Hiding License Code from UI

License Code

⚠️ This information is only for builds distributed directly through our website, it does not apply to builds distributed via Setapp or App Store.

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.

Migrating to a New Computer

If you have a new computer, you can install Permute on the new computer with your existing license code. If you have a Time Machine backup, you don’t really need to do anything, Time Machine will migrate all the files and Permute will repair the license code file on new launch (as it is bound to the original computer). If you do not have a Time Machine backup, download a new copy of Permute from our website and enter your existing 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 4 > Deactivate License Code… in the menu bar.

See alsoPermute's Webpage

Automation and Remote Deployment

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. You can automate both activation and deactivation of the license code via command line.

Remote Activation

open ‘permute4-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-4 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).

Remote Deactivation

open ‘permute4-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 4 > 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:

  • run the following command: defaults write com.charliemonroe.Permute-4 CMHideLicenseCodeFromUI -bool YES
  • or add &hide=true to the activation command, i.e.: open permute4-license://activate?email=my@email.com&license=XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX&hide=true

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