Install
Homebrew
Section titled “Homebrew”brew install --cask sergioarojasm98/tap/freeleappFreeleapp is in its own tap, not in the main Homebrew repository, hence the sergioarojasm98/tap/ prefix. The command adds the tap the first time. To use the short name, add the tap once yourself:
brew tap sergioarojasm98/tapbrew install --cask freeleappFreeleapp then updates itself, so brew upgrade skips it, and brew list --versions freeleapp keeps showing the version you installed with Homebrew. To upgrade through Homebrew anyway, run brew upgrade --cask --greedy freeleapp.
Download
Section titled “Download”- Download the latest
Freeleapp-<version>-arm64.dmgfrom GitHub Releases. - Open the DMG and drag Freeleapp to Applications.
- Open Freeleapp from Applications or Spotlight.
Freeleapp is signed with an Apple Developer ID and notarized by Apple, so macOS opens it without extra steps.
Moving from Leapp
Section titled “Moving from Leapp”You don’t need to copy anything by hand. The first time Freeleapp starts:
- It copies
~/.Leappto~/.freeleapp, so your sessions, integrations and named profiles appear as they were. Leapp plugins are not supported.~/.Leappis not modified and stays as a backup. - It moves each keychain item from the
Leappservice toFreeleappthe first time it is needed. macOS may ask you to allow Freeleapp to use an item; choose Always Allow.
The copy happens once. Changes you make later in Leapp are not brought over, so quit Leapp and use Freeleapp from then on. Once everything works, you can delete Leapp.app and, later, ~/.Leapp.
You may have to sign in to your identity provider once more, because browser login state is stored per app.
Uninstall
Section titled “Uninstall”With Homebrew:
brew uninstall --cask freeleapp # keeps your sessions and settingsbrew uninstall --cask --zap freeleapp # also removes ~/.freeleapp and the app's caches and logsWithout Homebrew, quit Freeleapp, delete it from Applications and, to remove your configuration, ~/.freeleapp. Keychain items stay either way: delete the Freeleapp entries in Keychain Access if you no longer need them.