The settings view¶
:settings opens it, and so does Shift+, (the <
key); esc always leaves it. Everything it
does is a careful edit of the same files described in the
rest of this guide, preserving every other line, so you can
mix the view and a text editor freely and neither will
trample the other.
The view has tabs; Tab and Shift+Tab move between them, and the status line always names the keys that work right now.
Accounts¶
Every configured account, one per row: its name, address and IMAP host. J / K select.
- A adds an account.
- E edits the selected one.
- D removes it, after a confirmation that names the
account (
delete work? y/n).
Removing an account deletes only its file under
accounts/. Your mail is never touched: the account's
maildir, and everything in it, stays in the store exactly as
it was, and putting the file back brings the account back.
Adding and editing happen in a form over the view: one row
per field, edited in place. Tab / Down and
Shift+Tab / Up move between fields, Enter on the
last field (or Ctrl+S from anywhere) saves, and Esc
cancels with nothing written. The fields are the same ones
the antiphon setup wizard asks for, and saving writes the
same file the wizard writes; there is exactly one account
format, whoever produced it.
The form covers password and app-password accounts. An
OAuth account (Microsoft 365, Google Workspace) is set up in
the account file plus antiphon oauth login instead; see
accounts.
Two fields deserve a word:
- Password: give a command that prints the password
(
pass show mail/personal,secret-tool lookup ...). On macOS you can instead leave the command empty and store the secret in the Keychain, which is what the setup wizard offers too. Nothing secret is ever written into the file itself. - Name: renaming an account renames its file; the store folder keeps the account's name, so rename before the first sync if you care what the directory is called.
Essentials¶
The daily-driver settings, edited in place: J / K select a row, H / L (or Left / Right / Enter) change its value.
| Row | What it changes | Takes effect |
|---|---|---|
| theme | the palette, previewed live as you cycle | immediately |
| sync interval (minutes) | how often antiphond does a pass | when antiphond restarts |
| idle | IMAP IDLE push on each INBOX | when antiphond restarts |
| reading pane | below, right or off | immediately |
| list rows | rows in the list when the pane is below | immediately |
| sidebar width | columns, clamped 10 to 40 | immediately |
Rows the daemon reads show the restart hint in the view itself, so there is no guessing which kind you changed. Numeric rows step by one and stop at their bounds; nothing you can do here writes an invalid value.
Folders¶
The third tab lists every discovered folder of every
account, with its sidebar alias where one is set. J /
K select, Enter starts editing the alias inline
(Enter saves it, Esc abandons the edit), and saving
an empty alias removes the mapping. The sidebar picks the
change up immediately; on disk it is the account file's
[folder_names] table, the same one described under
accounts.
Where it writes¶
Client settings land under [ui] and [sync] in
config.toml; account details land in that account's file
under accounts/. Each change is one surgical edit, made
atomically, and a local.toml override you keep for one
machine still wins afterwards, exactly as
configuration describes.