Skip to content

Troubleshooting

Default CLI editor

Espanso includes a configuration setting in the config file default.yml to set an editor as the default CLI editor. The purpose of this setting is to enable the user to type ‘espanso edit’ in the terminal to start the assigned editor. However, this setting does not have any effect in Windows. In order to set EspansoEdit as the default CLI editor in Windows it is necessary to manually add a user environment variable called EDITOR and set it to the full path of EspansoEdit.exe. This is described in more detail in the Espanso docs.

Tabs into spaces

Match files which contain tab stops may not be parsed by Espanso. In this case an Espanso error message is generated. The Edit menu includes an option to convert all tabs in the current file into spaces.

App fonts too small

If you are using a high DPI monitor or laptop the fonts in EspansoEdits dialogs and menus may appear too small. The following steps may resolve the issue:

  1. Right-click EspansoEdit.exe (or the EspansoEdit shortcut) and select Properties.
  2. In the Compatibility tab click the button to Change high DPI settings
  3. Check the box to Override high DPI scaling behavior and then set Scaling performed by: to System (Enhanced).

Portable packages

The Tools menus includes an item to set the active folder to the folder used by Espanso portable. The Packages menu is then set to the portable folder .espanso\match\packages. However, a duplicate packages folder exists if Espanso was previously installed and has not been removed. In this scenario, packages may be installed to the default location %appdata\espanso\match\packages even when portable Espanso is running.