Skip to content

File handling

EspansoEdit includes a filter so that only YML files are displayed in the file list. When the default folder is active the file list includes the match files from the $CONFIG/match folder. These files make up the base set of match files.

EspansoExpress is intended for creation and edit of Espanso match files. Files that are created or modified in EpansoExpress are listed with a specific icon as show here for the files ee_test*.yml:

Filelist icon

These files are tracked in each folder with a JSON file named ee_metadata.json.

If you select a YML file that has not been created or modified in Espanso Express, a dialog will appear with the following options:

  • Open the file with EspansoExpress
  • Edit the file with EspansoEdit
  • Go back and select another file

A YML file from an external source may cause parsing errors in EspansoExpress. If the file is modified in EspansoExpress, significant changes in formatting may occur when the file is saved.

The option to edit the YML file with EspansoEdit is useful for Espanso config files or in order to preserve existing formatting.

YML files created using the EspansoExpress convert function should open in EspansoExpress without any parsing errors.