Termhint license, free trial and activation
Updated 19 November 2026All docs
Termhint starts with a free trial and then needs a license key. This page covers the trial, buying and activating a key, the Macs it covers, how often it is checked, what locks when there is no license, and how to move a key to another Mac.
Free trial
The trial starts at Termhint's first launch on a Mac and lasts 7 days. You need no account, no email and no key for it, and every feature works during the trial.
- Settings → License shows the days left and the date the trial ends. The menu-bar panel's header shows a "Trial · N days" pill.
termhint licenseprints the time left and the date.- The trial's start is kept in your login keychain, not in the app, so deleting and reinstalling Termhint does not restart it.
Buy a license
A license is a one-time purchase. Termhint sells it through Polar, its reseller, with Polar's hosted checkout: you pay on Polar's page, never inside the app.
- In Settings → License, under Buy a license, pick the license for 1, 3 or 5 Macs. Each button opens Polar's checkout in your browser.
- Or buy from the pricing section of the home page, where the prices are.
VAT or sales tax for your country is added at checkout. Your key arrives by email from Polar and is also in Polar's customer portal.
Enter your key
- Open Settings → License. From a terminal,
termhint license openopens it. - Paste the key into Enter your key and click Activate.
The key is entered only in Settings → License, never on the command line, so it does not end up in your shell history. Lost the key? Settings → License → Find My Key in Polar opens the customer portal.
If the key is not accepted, Settings → License says why:
| Message | What to do |
|---|---|
| "Polar doesn't know this key." | Check it against your purchase email. |
| "This key is for another product, not Termhint." | Use the key from your Termhint purchase. |
| The key is on all the Macs it allows | Free a Mac in Polar's customer portal (Manage Macs), then try again. See Move a license. |
| "Couldn't reach Polar" | Check your connection and try again. |
How many Macs
A key works on as many Macs as the license you bought: 1, 3 or 5. Each Mac you activate takes one place. Settings → License and termhint license show the limit ("up to 3 Macs").
The activation is tied to the Mac by a hash of its hardware UUID; the UUID itself never leaves the Mac. In the customer portal the Mac shows under its model identifier (for example Mac14,2), never its name. More in privacy and security.
License checks and offline grace
Termhint checks the key with Polar about every 3 days while the app runs. To check right away, use Settings → License → Check Now. If your Mac's clock was set back, the next check happens at once.
- Offline, or Polar is down: the license keeps working. Termhint says it couldn't check and tries again later.
- 30 days without a successful check: Termhint locks with "Termhint couldn't check your license with Polar for 30 days." Connect to the internet and click Check Now.
- Polar says no (the key was refunded or disabled, or this Mac was removed from it in the portal): the key is removed from this Mac. Enter a key again, or buy one.
termhint license shows the date of the last successful check.
When Termhint is locked
Termhint locks when the trial has ended and no key is active, after 30 days without a check, or when a key's end date has passed.
While locked:
- The autocomplete popup does not open.
- The prompt theme gives way to the shell's own prompt. Your choice is kept and comes back with a license.
- Every Settings page except License is disabled.
termhintcommands stop, exceptlicense,uninstall,runtime exec,colors off,colors reset,colors native off,icons off,icons remove,icons font off,icons font none,specand help. These let you check the license and undo Termhint's changes.- Installed runtimes stay on PATH.
- Updates keep working.
The messages and their fixes are in troubleshooting.
Check the license from a terminal
termhint license # the trial's time left, or the license (key masked) and its last check
termhint license open # open Settings → License
termhint license is the same as termhint license status. Only Termhint.app reads the license, so the command asks the app and opens it in the background when it is not running. When locked, it prints why and where to buy a license.
Move a license to another Mac
Before you stop using a Mac, give its place back to the key:
- Open Settings → License.
- Click Deactivate This Mac… and confirm with Deactivate.
The key can then be activated on another Mac. Deactivating needs Polar: when the Mac is offline nothing changes, so the place is not lost. Try again once you are online.
If you no longer have the Mac, remove it in Polar's customer portal. Settings → License → Manage Macs opens the portal.
Customer portal
Polar's customer portal is where you find your key, see the Macs it is active on and remove one. Settings → License opens it with Manage Macs (when licensed) and Find My Key in Polar. What you enter there goes to Polar under its own privacy policy.
Refunds
The refund terms are on the refund policy page. A refunded key is removed from your Macs at their next license check.
Uninstalling and the license
Deactivate the Mac first (above) if you want to use the key elsewhere. The license record stays in the login keychain ("Termhint license") when the app is deleted, so a reinstall does not restart the trial. See uninstall.