id       = "mailmate"
name     = "MailMate"
homepage = "https://freron.com"
description = "An IMAP email client for macOS featuring extensive keyboard control and Markdown integrated email composition."
# The app icon from Freron's MailMate page.
icon     = "https://freron.com/images/MailMate_128.png"
# MailMate ships a command line: https://manual.mailmate-app.com/emate — the
# tool is `emate`, at /Applications/MailMate.app/Contents/Resources/emate, and
# the manual suggests symlinking it into ~/bin. Its bundle identifier is
# com.freron.MailMate; the binary is what a user types, so it wins.
executables   = ["emate"]
platforms = ["macos"]

[dotfiles]

# Two sources agree on the locations. The manual's hidden-preferences page
# (https://manual.mailmate-app.com/hidden_preferences) both documents the
# defaults domain — "defaults write com.freron.MailMate MmHeadersViewMaximum
# -integer 10", "defaults read com.freron.MailMate …" — and names the
# configuration files beside it: ~/Library/Application Support/MailMate/
# Identities.plist, LDAP.plist, Submission.plist, Security.plist and
# Resources/messageVerifications.plist. The customization page
# (https://manual.mailmate-app.com/customization) adds the two that matter most:
# "A custom version of a file can be made by making a copy in
# ~/Library/Application Support/MailMate/Resources/", and Mailboxes.plist, which
# holds the mailbox setup and "is located in the application support folder".
# The Homebrew cask's `zap trash:` list names the same two roots
# (https://formulae.brew.sh/api/cask/mailmate.json).
#
# Only the configuration files are listed, never the enclosing directory: the
# same folder holds MailMate's message store and index — the rebuild page
# (https://manual.mailmate-app.com/rebuild) describes "index files" there and an
# OldDatabase/ of backed-up databases — and syncing a live mail database between
# machines is not something this catalog should ask a consumer to do.
paths = [
  "[preferences]/com.freron.MailMate.plist",
  "[appData]/MailMate/Identities.plist",
  "[appData]/MailMate/Mailboxes.plist",
  "[appData]/MailMate/Security.plist",
  "[appData]/MailMate/Resources/",
]

# Nothing above encloses the message store or the index, so there is nothing to
# carve out of what is listed.

# Submission.plist configures the SMTP servers MailMate authenticates to and
# LDAP.plist the directory servers it binds to. MailMate's documentation does
# not say where the passwords for either are kept, and this catalog treats an
# unknown as a credential rather than the other way round, so both are listed
# here instead of under paths. A consumer that carries them does so through its
# own secret store.
secret = [
  "[appData]/MailMate/Submission.plist",
  "[appData]/MailMate/LDAP.plist",
]

# No machine_lines: everything above is a property list, and `match` reads only
# line-oriented files, TOML, YAML and JSON. What the files hold — identities,
# the mailbox tree, the customized resources — is what a user wants on the next
# Mac.