108 lines
4.0 KiB
Markdown
108 lines
4.0 KiB
Markdown
---
|
|
title: Install on Linux
|
|
layout: 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.
|
|
|
|
* [Ubuntu/Debian](#installing-on-ubuntu--debian)
|
|
* [Manjaro/Arch](#installing-on-manjaro--arch)
|
|
|
|
#### 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](https://github.com/federico-terzi/espanso/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](/docs/get-started/) tutorial.
|
|
|
|
### Installing on Manjaro / Arch
|
|
|
|
There are multiple ways to install espanso on Arch: the preferred method is by using the [AUR](#installing-from-aur) package,
|
|
but you can also install it manually from the [prebuilt executables](#installing-from-the-prebuilt-release).
|
|
|
|
#### 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](https://scrumplex.net/). There are multiple options available:
|
|
|
|
* [espanso-bin](https://aur.archlinux.org/packages/espanso-bin/) - Pre-compiled version for x64 systems.
|
|
* [espanso](https://aur.archlinux.org/packages/espanso/) - Builds from the latest (stable) release.
|
|
* [espanso-git](https://aur.archlinux.org/packages/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](https://github.com/federico-terzi/espanso/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](/docs/get-started/) tutorial. |