id       = "logitech-options"
name     = "Logitech Options"
homepage = "https://support.logi.com/hc/en-us/articles/360025297893-Logitech-Options"
# No description: Logitech's own support page for this product now carries only
# the end-of-support notice — "Logitech Options has reached end of support and
# is no longer maintained" — and no sentence describing the software. The entry
# is kept because the configuration is still on the machines that ran it; the
# successor, Logi Options+, writes elsewhere (~/Library/Application Support/Logi
# and LogiOptionsPlus, com.logi.optionsplus.plist) and is a separate entry's
# problem.
#
# No command line ships with it. The Homebrew cask's uninstall stanza names the
# identifiers the platform reports — `quit ["com.logitech.Logi-Options",
# "com.logitech.manager.daemon", "com.logitech.manager.uninstaller"]`
# (https://formulae.brew.sh/api/cask/logitech-options.json) — of which the first
# is the application the user sees.
executables = []
platforms = ["macos"]

[installation]
macos_bundle_ids = ["com.logitech.Logi-Options"]

[dotfiles]

# The same cask's `zap trash:` list names the user-level locations. The two
# under Application Support are where the per-device configuration lives — the
# button and gesture assignments, the per-application profiles, pointer speed —
# and Logitech has used both spellings across versions, so both are listed and
# a consumer syncs whichever exists:
#   ~/Library/Application Support/Logitech/Logitech Options
#   ~/Library/Application Support/Logitech/Options
# Alongside them, three preference domains:
#   ~/Library/Preferences/com.logitech.Logi-Options.plist
#   ~/Library/Preferences/com.logitech.manager.daemon.plist
#   ~/Library/Preferences/com.logitech.manager.setting.ffff.plist
# The last carries a device-scoped suffix in its name; ffff is the spelling the
# cask lists, and it is written here literally rather than globbed, because a
# glob would also swallow domains this entry has not verified.
paths = [
  "[appData]/Logitech/Logitech Options/",
  "[appData]/Logitech/Options/",
  "[preferences]/com.logitech.Logi-Options.plist",
  "[preferences]/com.logitech.manager.daemon.plist",
  "[preferences]/com.logitech.manager.setting.ffff.plist",
]

# The cask keeps the cache elsewhere (~/Library/Caches/com.logitech.Logi-Options)
# and the installer's own leftovers are under /Library, outside the home
# directory, so nothing above needs carving out.

# Logitech Options works against locally paired devices and stores no account
# credential under the home directory. Logitech Flow's pairing is held by the
# daemon rather than written as a credential file here.
secret = []

# No machine_lines: property lists have no matcher in this schema — `match`
# reads line-oriented files, TOML, YAML and JSON — and what these files hold,
# the per-device button assignments and per-application profiles, is exactly
# what a user wants to find on the next Mac. Device serial numbers in the
# per-device domain are machine-local, but they are inside a plist and cannot be
# named by a rule.