How to uninstall Espanso on Mac

Espanso is a text expander that runs in the background. Your matches, config files and installed packages live in one folder, ~/Library/Application Support/espanso, which Mole lists but does not select, so back it up before removing the app if you have written any expansions. This guide covers the official download for macOS and the Homebrew cask espanso.

Back up your matches

Espanso's configuration docs give the macOS config folder as ~/Library/Application Support/espanso; the ~/.config/espanso location they mention is the Linux one. Copy that folder somewhere outside ~/Library if you want to keep your matches.

Stop Espanso and remove the app

  1. Click Espanso's icon in the menu bar and quit it. If you use the espanso command, espanso stop stops the background service instead, as described in the command-line reference.
  2. In Finder's Applications folder, move Espanso to the Trash.
  3. Open System Settings › General › Login Items & Extensions. If Espanso is still listed there, turn it off.

Where its data lives

Location What it holds What to do
~/Library/Application Support/espanso Your matches, config and packages Listed but not selected. Back it up first.
~/Library/Caches/espanso Cache Selected by default
~/Library/Preferences/com.federicoterzi.espanso.plist App preferences Selected by default
~/Library/LaunchAgents/com.federicoterzi.espanso.plist Starts Espanso's background service at login, if it was registered Selected by default

Check the result

pgrep -il espanso
launchctl list | grep -i espanso
ls -d ~/Library/Application\ Support/espanso
  • No output from pgrep means no Espanso process is running.
  • No output from launchctl list means no Espanso job is loaded. A line containing com.federicoterzi.espanso means the background service is still registered; log out and back in after the LaunchAgent file is gone.
  • ls -d printing "No such file or directory" means your config folder is gone. A printed path means it is still there, which is expected if you left that row unticked.

If you installed it with Homebrew

The espanso cask links an espanso command and removes it with the app. Its zap list includes ~/Library/Application Support/espanso, the cache, the LaunchAgent, the preferences above, two more preference items named espanso and the saved window state. Because your config folder is listed but not selected, Mole leaves out --zap unless you tick that row, and still moves the rows you selected to the Trash itself.

Running the zap step yourself moves your matches and config to the Trash whatever you ticked in Mole:

brew uninstall --cask --zap espanso

To keep them, copy ~/Library/Application Support/espanso first, or remove only the app:

brew uninstall --cask espanso

What Mole lists

For Espanso installed from the official download:

  • ~/Library/Application Support/espanso is listed but not selected.
  • ~/Library/Caches/espanso, ~/Library/Preferences/com.federicoterzi.espanso.plist and the com.federicoterzi.espanso LaunchAgent are selected by default when they exist.
  • ~/.config/espanso is not listed on a Mac.

For a Homebrew install, the zap list reaches your config folder, so Mole leaves --zap out unless you tick that row.

What this test covered

On September 19, 2026, Espanso was copied from the official download into Applications, opened, and removed with a Preview build of Mole 1.15 (build 277); there was no Homebrew receipt. On first run it created an empty Application Support/espanso and did not write ~/.config/espanso. No matches were configured, the background service was not registered from the command line, and the Homebrew cask was not tested.