Navigating Folders¶

This page documents the folder tree — the FolderView widget down the left side of the main window. It lists your accounts and their folders, and selecting a folder here is what drives the message list on the right. It also covers creating, renaming, moving, and deleting folders, and how app folders behave.

How the tree is organized¶

The folder tree is hierarchical:

• Accounts sit at the top level. Each configured account is a root row.

• Prime folders are the built-in folders under each account:

  Prime folder	Purpose
  Inbox	Incoming messages.
  Outbox	Messages queued to send (including delayed sends).
  Sent	Messages you have sent.
  Drafts	Unsent messages saved for later.
  Trash	Deleted messages and folders.
  Junk	A view of spam messages gathered from all other folders (except Trash).
  Apps	The launcher and your installed apps.

• Custom folders are the folders you create. They nest under a prime folder (or under another custom folder) to any depth.

• App folders live under Apps: an app root per installed app, with one app instance folder beneath it per running instance.

Prime folders¶

Every account is created with the same set of built-in prime folders. They always exist, always appear in the same order, and — unlike custom folders — cannot be renamed, moved, or deleted. Their names (inbox, outbox, sent, drafts, trash, junk, apps) are reserved, so a custom folder may not reuse them (see New Folder).

Inbox ¶

Where incoming messages arrive. This is the folder shown when there is nowhere more specific to return to — if your last folder can no longer be found on restart, the view falls back to a prime folder.

Outbox ¶

A staging area for messages on their way out — anything queued to send but not yet delivered, including delayed (timed) sends. The Outbox exposes extra controls in the message list: Retry Send for a failed message and Cancel Send for one still waiting for its scheduled time. A message leaves the Outbox for Sent once it is delivered.

Sent ¶

A copy of every message you have successfully sent.

Drafts ¶

Unfinished messages saved for later, both those you save explicitly and the temporary autosaves the compose window keeps. Opening a message here reopens it in the compose window for editing rather than in a read-only view — see Opening a message.

Trash ¶

Where deleted messages and folders land first. Deletion is two-stage: items move here and stay recoverable until Trash is emptied or they are deleted again from within Trash, which is permanent. Right-click Trash for Empty Trash.

Junk ¶

Unlike the other prime folders, Junk holds no messages of its own — it is a view. It is a live query that gathers every message flagged as spam (by spam score or an explicit junk mark) from every other folder in the account except Trash. Each message it shows physically still lives in its real folder — the Inbox message, the custom-folder message, and so on; Junk simply collects them in one place.

Because of this, Junk behaves differently from a normal folder: it has no folder context menu, and you cannot drag messages out of it (the message isn't in Junk to begin with). It also applies its spam filtering on top of any search.

Apps ¶

The home for the launcher and your installed apps. The Apps row itself acts as the Launcher; beneath it sits an app root per installed app and an app instance folder per running instance. Selecting an app instance opens the app instead of a message list. App folders have their own context menu and include non-deletable system apps.

Selecting a folder¶

Click a folder (or move to it with the arrow keys) to make it current. Selecting a folder:

• Loads its messages into the message list.
• Remembers it as the previous folder, so the app can track where you came from.
• Selecting an app instance folder opens that app instead of showing a message list; the Apps row itself acts as the Launcher.

Expanding and collapsing¶

Expand a folder to reveal its subfolders, or collapse it to hide them. The expanded/collapsed state of each folder is remembered and restored, so the tree reopens the way you left it.

Recursive folders¶

Each folder that has subfolders offers a Recursive toggle in its context menu. When Recursive is on, selecting that folder shows the messages from all of its subfolders as well as its own; when off, only the folder's own messages are shown.

Creating, renaming, and organizing folders¶

Right-click a folder (or empty space) to open the context menu. Which menu appears depends on what you click:

New Folder¶

New Folder opens a dialog to name the folder. Chosen from a folder, the new folder is created inside it; chosen from empty space (New Folder top-level), it is created at the account's root.

Folder names are validated:

• They cannot be empty.
• They cannot contain the /, %, \, or : characters.
• They cannot reuse a reserved prime-folder name.

The full path is also checked, so you cannot collide with a prime folder or create a folder that already exists.

Rename Folder¶

Rename Folder prompts for a new name (the same name rules apply).

Move¶

Move a custom folder either through the Move ▸ submenu or by dragging it onto its new parent in the tree. Dragging messages from the message list onto a folder moves those messages (and any nested replies) into it.

Deleting folders and emptying Trash¶

Deleting follows a two-stage, Trash-based model:

1. Delete a folder that is not in Trash → it is moved to Trash after a confirmation. Its layout/state is preserved so it can be restored intact.
2. Delete a folder that is already in Trash → it is permanently deleted after a stronger, "this cannot be undone" confirmation.

After a delete, the view selects the nearest remaining folder (for a single selection) so you are not left on nothing. You can select and delete a mix of in-Trash and not-in-Trash folders at once; each is handled by the appropriate rule.

Empty Trash (on the Trash folder's menu) permanently removes everything in Trash after an "this cannot be undone" confirmation.

App folders¶

Folders under Apps have their own context menu:

Deleting an app instance asks for confirmation and removes it permanently.

System apps¶

Three apps are built in and always present. They are system apps, so they cannot be deleted, and they each manage a different scope of your installation:

The App Manager and Mailbox Manager can also be opened directly from the Message menu.

Icon reference¶

The prime-folder icons:

Folder	Icon
Inbox
Outbox
Sent
Drafts
Trash
Junk
Apps
Custom folder	/