Update Termhint: automatic and manual checks
Updated 19 November 2026All docs
Termhint updates itself with Sparkle, the update framework many Mac apps use. This page covers the daily check and its switch, checking by hand, how an update is verified, version numbers, Homebrew and where to read what changed.
Automatic checks
Termhint checks for a newer version once a day. The switch is Settings → App → Updates → Check automatically, on by default.
When a daily check finds a version, Termhint does not open a window behind your other apps. Instead:
- The version in the menu-bar panel's header becomes an "Update · X.Y.Z" button.
- The menu-bar icon gets a dot.
Click the Update button to see the release notes and install. Right after Termhint launches, Sparkle may show its update window itself.
Updates work in every license state: during the trial, with a license and while Termhint is locked.
Check now
- Menu-bar panel: click the version in the panel's header. An arrow shows on hover and a spinner while it checks. With nothing newer, the pill reads "Up to date" for a moment and no window opens. For an update or an error, the panel closes and Sparkle's window shows it.
- App menu: Check for Updates… in the Termhint menu, in the menu bar while Termhint is in front (for example with Settings open). It always answers in Sparkle's window, also when you are up to date.
Install an update
Sparkle's window shows the release notes, the same text as the changelog entry, and installs the update from there.
Signed updates
An update installs only if both checks pass:
- It carries Termhint's EdDSA signature, matching the public key built into the installed app.
- The new app is signed by the same Apple Developer ID team as the installed one.
Releases are also notarized by Apple. If Sparkle refuses an update, download Termhint again from termhint.com and replace the app.
A check sends an ordinary request to termhint.com: your IP address and the app's name and version. Sparkle's system profile is not turned on. Details in privacy and security.
Versions
Termhint's versions read X.Y.Z (for example 1.4.1), without build numbers. The version is in the menu-bar panel's header and in About Termhint in the app menu.
Homebrew
If you installed Termhint with Homebrew (brew install --cask toni1703/termhint/termhint), Sparkle still updates it as above. The cask is marked as updating itself (auto_updates), so a plain brew upgrade leaves it alone. To update it through Homebrew anyway:
brew upgrade --cask --greedy toni1703/termhint/termhint
What changed
Every release and its changes are in the changelog.
Updates not showing
See troubleshooting.