id       = "espanso"
name     = "espanso"
homepage = "https://espanso.org"
description = "A Privacy-first, Cross-platform Text Expander written in Rust"
# The project's own logo, from its homepage.
icon     = "https://espanso.org/img/logo.png"
executables   = ["espanso"]

[dotfiles]

# https://espanso.org/docs/configuration/basics/ names the configuration
# folder per platform: "$XDG_CONFIG_HOME/espanso" on Linux,
# "$HOME/Library/Application Support/espanso" on macOS and "%AppData%\espanso"
# on Windows — the platform-native config directory under all three names, so
# [appData]. The same page splits it in two: config/ "defines _HOW_ Espanso
# should perform its expansions and behave" (default.yml and any per-app
# override), match/ "defines _WHAT_ Espanso should do" (base.yml and the rest
# of the user's snippets).
paths = [
  "[appData]/espanso/config/",
  "[appData]/espanso/match/",
]

# https://espanso.org/docs/packages/basics/: installed packages "are stored
# alongside your YAML matches, under the `packages` directory". They are
# downloaded from the Espanso Hub by `espanso install <name>`, so the list of
# what to install travels in the config and the checkout does not.
exclude = [
  "[appData]/espanso/match/packages/",
]

# Snippets and behaviour settings. espanso has no credential file. A snippet
# body could of course hold anything the user typed into it, which is the
# user's own text and not something this entry can classify.
secret = []

# No machine_lines: the per-application `filter_exec` / `filter_title` rules,
# the toggle key and the backend are preferences a user wants on every
# machine. espanso does record a per-machine path in its config only when the
# user writes one by hand, and there is no fixed key for it.