Repository navigation
Releases
Releases · retrography/mailman
v0.11.0
Changed
- The configuration files now live in Home Assistant's configuration folder, in
mailman/, so they can be
edited, versioned and backed up with the rest of it. Everything else (the log, the test set, caches and the
mailbox sign-ins) lives in the app's private folder, which no other app (file editor, Samba, VS Code) can
read, and which is in the app's own backup. - The first start copies both from
/addon_configs/<…>_mailman/, compares every file with its copy, and
leaves the old folder untouched with aMOVED.txtnote; delete it once you are happy. If the copy fails, the
app stops instead of starting on a fresh configuration. - The mailbox sign-ins are one file,
tokens.json:token.jsonandtoken-outlook.jsonare taken into it at
the first start and removed. - A label's sender index (such as Blocked's) is one file for every mailbox:
blocked_index.jsonand
outlook_blocked_index.jsonare merged at the first start. - Running it yourself:
mailman authstores the sign-in indata/tokens.json(orMAILMAN_TOKENS); its
--outand theMAILMAN_TOKEN_FILEandMAILMAN_OUTLOOK_TOKEN_FILEsettings are gone. A container keeps
config/anddata/inMAILMAN_HOME(default/config), as before.
v0.10.1
Changed
- The page with actions and triggers is called Automations, at
#/automations; its tabs stay Actions and
Triggers. The old addresses#/actionsand#/jobsno longer open it. - An action's
then_runfield is labelled "post". - Labels that apply to any mailbox no longer say Gmail: "search", "label", the Outcomes page, lookups, list
sources, and the label clean-up.
v0.10.0
Added
- An action setting
then_run: the emails an action changed then go through an action that applies the rules,
at the daemon's next round. The starter'sunblockrunsclassify, so unblocked mail is filed, labelled or
deleted like new mail instead of all landing in the inbox. The Actions page has a field for it.
Existing installations keep their configuration: add then_run: classify to the action unblock (Actions).
v0.9.0
Added
- A list setting
on_removed_entry: a job that runs, in every mailbox, for each entry you take off the list in
the interface. The save dialog lists those entries before you save, and Health shows what each run did. - The starter configuration's blocked list runs
unblockfor a sender you take off it, and a new action
trash_blockedsends what you move to Blocked to Trash.
Fixed
- A sender taken off the blocked list came back at the next block. Their mail kept the Blocked label, and the
list is filled from that label. Withon_removed_entry: unblockthe label comes off with the entry. - Mail you moved to Blocked stayed there.
trash_blockedsends it to Trash; until now only the sender's
other mail was trashed.
Existing installations keep their configuration. To get both fixes, add on_removed_entry: unblock to the
blocked list (Lists), and the action trash_blocked with a trigger label_added: Blocked (Actions).
v0.8.0
Changed
- Outlook: a label is a folder of that name instead of a category, which no mail client shows. Folders are
made when first needed (Travel/2026is a subfolder), and your own folders count as labels. Filing puts
mail in the folder of its first label, or in Archive without one. - Outlook: moving an email to the Blocked folder blocks its sender, from wherever it was moved. Mailman makes
the folder when it starts.
Fixed
- Outlook: undoing a delete or a spam brings the email back where it was, not to Archive.
v0.7.1
Added
- Logs: a Mailbox column says which mailbox (Gmail or Outlook) each email was handled in.
v0.7.0
Added
- A second mailbox: Outlook.com or Microsoft 365, through Microsoft Graph, sorted by the same rules as Gmail.
Connect it on Health (a code typed on Microsoft's page) or withmailman auth --outlook; it needs your own
Microsoft app registration (optionsoutlook_client_idandoutlook_tenant). Labels become categories,
filing moves mail to Archive, and new mail is noticed within a minute. The Documentation tab lists what
differs from Gmail. - Settings
outlook.poll_secondsandoutlook.archive_folder.
Changed
- One daemon runs per connected mailbox, and Health shows each.
mailman daemonstarts one process per
mailbox;--accountruns a single one. - The log records which mailbox each email is in, and undo and "This was wrong" act there. An existing log is
upgraded at the first start; its emails count as Gmail's. - A job run from Actions runs in every connected mailbox.
v0.6.0
Added
- A Test set page: every email the configuration is checked against (the cached sample and the emails you
marked), what the rules do with each now, and whether that is what you expect. Open one to read it, set or
clear the outcome and labels you expect, add a note, edit the classifier's stored answers, or remove it from
the test set.
Changed
- The Automations page is now called Actions, at
#/actions; the old#/jobsaddress still opens it.
v0.5.1
Fixed
- After an update the browser could show the new page with the previous version's script: the Backup link
opened Logs, and Import was still on Health. The page is now sent as one document, script and styles
included, and is never cached.
v0.5.0
Added
- A Backup page with Export (the configuration, or everything including the log and the test set) and Import.
Changed
- Import moved from Health to the Backup page.
Fixed
- An import started from a page that was still an older version failed with "[object Object]". The server now
accepts the upload in either form.