Synchronization

At some point, you might need to synchronize your configuration between devices. Luckly, the Espanso file-based configuration makes it easy, letting you synchronize the config using any Cloud Storage service (such as Dropbox, Google Drive, ecc) or even GitHub!

tip

From now on, we'll only mention "Dropbox folder" for brevity, but you can apply the same process for every service.

The general idea, which applies to all operating systems, is the following:

• Move the Espanso configuration folder inside your Dropbox folder (also a subdirectory is perfectly fine)
• Create a symbolic link in the original position, pointing to the synced folder.

Before diving in the actual process, you'll need to determine the current Espanso's configuration path used on your system. To do so, open a terminal and type:

espanso path config

The command's output is the configuration path, make sure to note it somewhere as you'll need it later. From now on, we'll refer to this path as $CONFIG.

Note: you do not need the final 'espanso' folder when entering the path. For example if the path returned by espanso path config is /Users/myname/Library/Application Support/espanso your $CONFIG value should be /Users/myname/Library/Application Support/

The specific commands are explained in the following sections, depending on your OS.

Make sure to replace $CONFIG!

In the following sections, we'll refer to the current configuration path as $CONFIG. Make sure to replace it with the actual path, determined in the previous section.

For example, if you see this command:

mklink /J "$CONFIG" "C:\Users\user\Dropbox\espanso"

You should run something like:

mklink /J "C:\Users\user\AppData\Roaming\espanso" "C:\Users\user\Dropbox\espanso"

Stop Espanso first

Before running any of the following, stop espanso with:

espanso stop

to prevent it trying to recreate the file structure during the process.

Before running mklink or ln ensure the espanso folder at the end of $CONFIG no longer exists, because it has been moved, or copied and renamed.

Windows

The first step is moving the $CONFIG folder inside your Dropbox directory, for example in:

C:\Users\user\Dropbox\espanso

Now you need to create a symbolic link. Open the Command Prompt and type the following command, making sure you specify the correct paths:

mklink /J "$CONFIG" "C:\Users\user\Dropbox\espanso"

Now restart Espanso and you should be ready to go!

macOS

The first step is moving the $CONFIG folder inside your Dropbox directory, for example in:

$HOME/Dropbox/espanso

Now you need to create a symbolic link. Open the Terminal and type the following command, making sure you specify the correct paths:

ln -s "$HOME/Dropbox/espanso" "$CONFIG"

Now restart espanso and you should be ready to go!

Linux

The first step is moving the $CONFIG folder inside your Dropbox directory, for example in:

/home/user/Dropbox/espanso

Now you need to create a symbolic link. Open the Terminal and type the following command, making sure you specify the correct paths:

ln -s "/home/user/Dropbox/espanso" "$CONFIG"

Now restart espanso and you should be ready to go!