What waits for me
This page explains how tt shows the mail you have not read, and what Tilde keeps about the mentions and the direct messages that wait for you.
What tt shows today
Section titled “What tt shows today”tt --demo- In the list,
Nmarks a message you have not read.*marks a flagged one. - In the tree, a folder with unread messages shows how many at the end of its row:
INBOX 12. - Both follow the mail as it changes: a message whose Seen flag is set loses its
N, and the number goes down, without a key. This holds for IMAP and Maildir accounts.
tt does not show chat accounts yet, and it does not show the list below yet. No key opens it.
The list that Tilde keeps
Section titled “The list that Tilde keeps”Tilde itself keeps one live list of what waits for you, newest first. It holds three kinds of item:
| Kind | What adds it |
|---|---|
| Unread mail | a message without the Seen flag in the INBOX of a mail account |
| Direct message | a chat message in a direct conversation |
| Mention | a chat message in a room that mentions you |
- A room message that does not mention you is not an item.
- A message that is both a direct message and a mention gives one item.
- Mail counts only in the INBOX. Other folders are not looked at.
- When the accounts have started, Tilde reads the newest 200 messages of every INBOX once and adds the unread ones. Chat has no such read: the items come from the messages the server delivers after the connection.
- An account that is not connected adds nothing, and that is not an error.
What takes an item away
Section titled “What takes an item away”Read anywhere is read here.
- Mail: the Seen flag, a delete, or a move out of the INBOX. Tilde looks at every INBOX again once a minute, so a mail read on another device goes away within a minute even when its store does not say so.
- Chat on XMPP: a chat marker from your other devices says that you read the conversation up to a message, and its items go. A message you send from another device, and your own message in a room, count as reading the conversation.
- A chat message that is withdrawn takes its item with it.
A mail rule with mark_read sets the Seen flag, so its mail leaves the list as soon as it arrives. A chat rule can mark a conversation read.
Limits
Section titled “Limits”- The list lives in memory. After a restart the chat items are gone, and the mail items come back from the read of the INBOX.
- It holds at most 500 items. When it is full the oldest go.
- There are no notifications and no sounds.
The code is WhoNeedsMeService.