Skip to content

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.