Skip to main content
Version: v2.2.1


Espanso v2 is finally here! This tutorial will help you to quickly get started with the new version, starting from the installation and later diving into the main architectural differences.

The tutorial is divided in steps. You can navigate through them using the "next" button at the bottom right or by using the navigation bar on the left.

  • Uninstalling the previous version: If you already have the legacy version (0.7.3) installed, you will need to uninstall it from your machine to avoid conflicts with the new version. This tutorial will guide you through the process.

  • What changed in v2 covers the main differences between the legacy version and v2 when it comes to configuration files.

  • The Configuration changes section is an in-depth walkthrough of what changed in the new configuration format, as well as the reasons behind those changes.


The author of the project

Hi! I'm Federico, the creator of espanso. I develop espanso in my (little) spare time and I decided to make it open source because I thought it could be useful to many people.

If you liked the project, please consider making a small donation, it really helps :)

A special thanks goes to all the wonderful people who supported espanso along the way

Together, we will make espanso the first universal text expander, open to everyone.


Espanso is open source and hosted on GitHub.


If you find a bug or have an idea for a new feature, please open an issue on GitHub.