Lists, searches, reads, marks, moves and labels mail, drafts or sends email - as HTML made from the text by default, or as plain text with format: text - drafts or sends a reply threaded to the message it answers, says whether a message was replied to, follows a message until it is, and watches a folder for new mail, over an IMAP app-password mailbox, Microsoft or Google.
8.0 MB. Check the download against its SHA-256 below.
What it contains
- Settings: Mode, Format, Send allowlist, Allow mark read, Move and label folders, Most messages per command, Most body characters, Watch folder, Watch unread only, Watch senders, Watch query, Watch lookback days, Quiet hours start, Quiet hours end, Quiet hours time zone
- Sign-ins: Mailbox
- Events: One check of the watch found new mail, or mail nobody acknowledged yet: every such message, never a body. One check of the watch found followed messages with no reply yet whose reminder interval has passed, outside quiet hours: every such message, never a body. Published only when at least one is due. One check of the watch found followed messages with a reply from this mailbox in Sent: every such message, no longer followed, never a body. Mail sent one email: the send command, or reply, in send mode. One event per message sent; never a body, an address or an attachment. Mail saved one draft: the draft command, send in draft mode, or reply in draft mode. Nothing was sent; never a body, an address or an attachment. Mail marked one message read or unread, moved it or labelled it. One event per message; Mail never deletes.
- Skills: plugin-mail-plugin
What it does
Drafts only by default; sends only to a person's allowlist; never deletes.
What it needs
Accounts you connect
- Mailbox required
Gmail, iCloud, Yahoo, Outlook or another IMAP mailbox
The mailbox to read, draft and send from: an IMAP app password (Gmail, iCloud, Yahoo, other), a Microsoft account or a Google account.
Settings you choose
modeoptionaldraft saves a draft the person sends from their mailbox and never sends anything; send sends, and only to addresses on sendAllowlist.
sendAllowlistoptionalWho it may draft to or send to: full addresses (person+tag@example.com) or whole domains (@example.com). Case is ignored; a +tag must match exactly as written. Every To, Cc and Bcc recipient must be on it, in draft mode too.
markReadoptionalLets mark-read and mark-unread change whether a message is read. Off: both are refused.
moveTooptionalThe only folders and labels move and label may use (Archive, Receipts). One the mailbox does not have is created at the top level on its first move or label; a nested one (Clients/Acme) must exist, and Junk, Sent and Trash are never created. The folders command lists what exists. Empty: move and label are refused. Nothing is ever deleted.
followQuietStartoptionalWhen follow reminders stop each day, as HH:MM in followTimeZone (22:00). Empty, or followQuietEnd empty: no quiet hours. In quiet hours the watch lists no followed message as unanswered; the first check after lists each one due, once.
followQuietEndoptionalWhen follow reminders start again each day, as HH:MM in followTimeZone (07:00). Empty, or followQuietStart empty: no quiet hours.
followTimeZoneoptionalThe IANA time zone quiet hours are in (Europe/London, America/New_York). Default UTC.
Setting it up
Accounts you connect
- Mailbox required
Gmail, iCloud, Yahoo, Outlook or another IMAP mailbox
The mailbox to read, draft and send from: an IMAP app password (Gmail, iCloud, Yahoo, other), a Microsoft account or a Google account.
Settings and secrets
- Mode optional
Default: draft
draft saves a draft the person sends from their mailbox and never sends anything; send sends, and only to addresses on sendAllowlist.
- Format optional
Default: html
html sends the body as written plus an HTML version made from it (Markdown: headings, bold, lists, links; HTML tags in the body are shown as text, never used); text sends plain text only.
- Send allowlist optional
No default.
Who it may draft to or send to: full addresses (person+tag@example.com) or whole domains (@example.com). Case is ignored; a +tag must match exactly as written. Every To, Cc and Bcc recipient must be on it, in draft mode too.
- Allow mark read optional
Default: Off
Lets mark-read and mark-unread change whether a message is read. Off: both are refused.
- Move and label folders optional
No default.
The only folders and labels move and label may use (Archive, Receipts). One the mailbox does not have is created at the top level on its first move or label; a nested one (Clients/Acme) must exist, and Junk, Sent and Trash are never created. The folders command lists what exists. Empty: move and label are refused. Nothing is ever deleted.
- Most messages per command optional
Default: 20
The most messages one command reads: list and search (a max:<n> may only lower it), the ids one mark, move or label takes, and the new messages one watch check takes.
- Most body characters optional
Default: 20000
read cuts a message's body to this many characters and says it was cut.
- Watch folder optional
Default: INBOX
The folder watch checks for new mail.
- Watch unread only optional
Default: On
watch lists only new mail that is still unread.
- Watch senders optional
No default.
When set, watch lists only mail whose sender contains one of these (an address or @example.com).
- Watch query optional
No default.
When set, watch lists only mail matching it: from:<text>, subject:<text>, and words that must appear in the sender, subject or snippet.
- Watch lookback days optional
Default: 0
How many days back the first check lists mail that is already there. 0: the watch starts from now.
- Quiet hours start optional
No default.
When follow reminders stop each day, as HH:MM in followTimeZone (22:00). Empty, or followQuietEnd empty: no quiet hours. In quiet hours the watch lists no followed message as unanswered; the first check after lists each one due, once.
- Quiet hours end optional
No default.
When follow reminders start again each day, as HH:MM in followTimeZone (07:00). Empty, or followQuietStart empty: no quiet hours.
- Quiet hours time zone optional
Default: UTC
The IANA time zone quiet hours are in (Europe/London, America/New_York). Default UTC.
Details
- Kind
- Plugin
- Version
- 3.0.1
- Plugins
mail-plugin3.0.1- Platforms
- Linux x64, Linux Arm64
- Size
- 8.0 MB (8,420,447 bytes)
- SHA-256
39a5f96dbf4f1a641dd85e413e10479f8ecc3c80c2133295e5d76104d1fd15b8- Download
- mail-plugin-3.0.1.zip
- Source
- github.com/djlsystems/Yawble-packages/tree/main/packages/mail-plugin
- License
- Apache License 2.0 (Apache-2.0), separate from the license of Yawble itself
How to install
In Yawble, open Marketplace, find Mail under Browse and press Get. Or download the .zip, then in Yawble:
- Admin
- Plugins
- Install from a folder
You see what the package adds before it goes in, and you connect its accounts and set its keys afterwards.