4.0 KiB
| title | layout |
|---|---|
| Install on Linux | docs |
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/bindirectory instead. Make sure that the~/.local/bindirectory is in thePATH. 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/bindirectory instead. Make sure that the~/.local/bindirectory is in thePATH. 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.