macspanso logo

macspanso

A native macOS menu bar app for managing espanso text expansion matches — no YAML editing required.

macOS 13+ MIT License
Download DMG View on GitHub

Installation

macOS 13 Ventura or later espanso (auto-installed via Homebrew)

Homebrew recommended

brew install --cask jeffcaldwellca/tap/macspanso

Automatically installs espanso as a dependency if it isn't already present.


Direct download

Download the latest .dmg from the Releases page, open it, and drag macspanso to your Applications folder.

What it does

Create matches

Type a trigger, type the replacement, save. No YAML, no terminal.

Form matches

Add [[placeholders]] and espanso will show a fill-in popup before expanding.

Variables

Attach date, shell, clipboard, random, and other variable types to any match.

Multi-trigger & regex

One match, many triggers — or match by regular expression for maximum flexibility.

File tree view

Browse matches by YAML file or as a flat list. See exactly where each match lives.

External edit detection

A banner appears when a file changes outside the app, with reload or keep options.

Menu bar controls

Enable, disable, or restart espanso without leaving the keyboard.

Search

Filter matches instantly by trigger, replacement preview, or label.