config.toml: cache, pgp

This page lists every key of the tables [cache] and [pgp] of config.toml, with its type and default.

Both plugins are off until their table says enabled = true. Check a file after every change:

tcli check

[cache]

The mail cache keeps the messages of the remote accounts on the disk, with a full text index. See Cache.

Key	Type	Default	Meaning
enabled	boolean	false	Turns the mail cache on. It writes mail on the disk, so it is off until it is asked for.
size_max	text	"1GB"	The largest size of the cache file of one account: a number with KB, MB or GB, any case, a space allowed. A number without a unit is refused.
encrypt_key	text	none	The key that encrypts the cache files, best as #{command}. Missing or blank: the files are not encrypted.

An account stays out of the cache with cache = false in the settings of its store: see config.toml: accounts.

[pgp]

OpenPGP runs the gpg program. See OpenPGP.

Key	Type	Default	Meaning
enabled	boolean	false	Turns OpenPGP on. It runs a program, so it is off until it is asked for.
gpg	text	looked for	The path of gpg. Without it Tilde looks in the PATH, and on Windows first in the folder of Gpg4win.
home	text	the one of the system	The home folder of GnuPG (--homedir).
keyserver	text	the one of dirmngr.conf	The keyserver to ask, such as hkps://keys.openpgp.org.
auto_locate	boolean	true	A search for the key of an address goes on to the keyserver when the domain has no Web Key Directory. false: only the domain can give a key.
encrypt_to_self	boolean	true	An encrypted message is also encrypted to the key of the sender, who can then read the sent copy.
default_sign	boolean	false	A draft that does not say what to do (no Security) is signed.
default_encrypt	boolean	false	A draft that does not say what to do is encrypted. A message to someone without a key is then not sent, unless the draft asks for no protection.
keys	table	empty	The key of each sender address, as [pgp.keys] with "ada@example.org" = "<fingerprint>". A sender not in the table uses the key of its address.

The gpg_key of a mail account names the key of that account: see config.toml: accounts.

An example

[cache]
enabled = true
size_max = "500 MB"
encrypt_key = "#{pass show tilde/cache}"

[pgp]
enabled = true
keyserver = "hkps://keys.openpgp.org"
auto_locate = false
default_sign = true

[pgp.keys]
"ada@example.org" = "0xFE67774DF63A2BB6"

The code of the tables is in CacheConfig.cs and PgpConfig.cs.