Install on Linux

The linux installation depends on the distro you are using. Espanso has been tested in the following distros, but you shouldn’t have many problems making it work on others.

Wayland support

Currently espanso supports X11 systems only.

Installing on Ubuntu / Debian

Espanso depends upon the X11 Record Extension, the xdo library and the xclip command, so you will need to install those first with the following commands:

sudo apt update
sudo apt install libxtst6 libxdo3 xclip

You can now download the latest espanso release:

curl -L https://github.com/federico-terzi/espanso/releases/latest/download/espanso-linux.tar.gz | tar -xz -C /tmp/

If you want to verify the correctness of the archive, in the Github Releases page you will find the SHA256 hash in the file espanso-linux-sha256.txt.

And then move it to the /usr/local/bin/ directory

sudo mv /tmp/espanso /usr/local/bin/espanso

If you want to avoid using sudo, you can move espanso in the ~/.local/bin directory instead. Make sure that the ~/.local/bin directory is in the PATH. If not present, you may need to reboot the system.

You should now have espanso installed in your system. To start it, type the following command:

espanso start

If you now type :espanso in any text field, you should see “Hi there!” appear!

At this point, you are ready to read the Getting Started tutorial.

Installing on Manjaro / Arch

There are multiple ways to install espanso on Arch: the preferred method is by using the AUR package, but you can also install it manually from the prebuilt executables.

Installing from AUR

The official way to install espanso on Arch-based systems is by using one of the AUR packages, currently maintained by Scrumplex. There are multiple options available:

  • espanso-bin - Pre-compiled version for x64 systems.
  • espanso - Builds from the latest (stable) release.
  • espanso-git - Builds from latest commit ( in master branch ).

If you are using a 64 bit machine, you should prefer espanso-bin as it is much faster to install. If you have a 32 bit system, or prefer compiling espanso from sources, you should use the espanso package instead.

When you are ready, you can install espanso with:

git clone https://aur.archlinux.org/espanso-bin.git
cd espanso-bin
makepkg -si

Installing from the prebuilt release

Espanso depends upon the X11 Record Extension, the xdo library and the xclip command, so you will need to install those first with the following commands:

sudo pacman -Sy
sudo pacman -S libxtst xdotool xclip

You can now download the latest espanso release:

curl -L https://github.com/federico-terzi/espanso/releases/latest/download/espanso-linux.tar.gz | tar -xz -C /tmp/

If you want to verify the correctness of the archive, in the Github Releases page you will find the SHA256 hash in the file espanso-linux-sha256.txt.

And then move it to the /usr/local/bin/ directory

sudo mv /tmp/espanso /usr/local/bin/espanso

If you want to avoid using sudo, you can move espanso in the ~/.local/bin directory instead. Make sure that the ~/.local/bin directory is in the PATH. If not present, you may need to reboot the system.

You should now have espanso installed in your system. To start it, type the following command:

espanso start

If you now type :espanso in any text field, you should see “Hi there!” appear!

At this point, you are ready to read the Getting Started tutorial.