Text expansion, kept simple.

A native desktop editor for Espanso match files. Espanso GUI makes it easier to create, review, and maintain text-expansion rules without editing YAML by hand, while keeping your existing Espanso configuration in control.

Go to Downloads Source Code
Available for Linux, macOS, and Windows.
Espanso GUI Screenshot

Downloads

Pick your package.

Choose the appropriate package for your operating system.

Linux

Pre-built binary packages for common Linux distributions:

Debian / Ubuntu .deb
Download Debian/Ubuntu (.deb)
Arch Linux .pkg.tar.zst
Download Arch (.pkg.tar.zst)
macOS

Native disk images for Apple silicon and Intel Macs.

Apple silicon arm64
Download macOS (Apple silicon)
Intel Mac x64
Download macOS (Intel)
Windows

Portable archive for 64-bit Windows systems. Extract it and run Espanso GUI.exe.

Windows x64 .zip
Download Windows (.zip)

Installation via Terminal

Instructions for installing or running directly from source code.

Quick install for Linux

Detects Debian, Ubuntu, Arch Linux, and compatible distributions. 

curl -fsSL https://raw.githubusercontent.com/johannjdk/espanso-gui/main/scripts/install-linux.sh | sh
Debian / Ubuntu 
sudo dpkg -i espanso-gui-all.deb
sudo apt-get install -f
Arch Linux 
sudo pacman -U espanso-gui-any.pkg.tar.zst
Run from Source

Requires Python 3.10+ and PySide6 

git clone https://github.com/johannjdk/espanso-gui.git
cd espanso-gui
python3 -m venv .venv
source .venv/bin/activate
pip install .
python3 -m espanso_gui