Format:Maildir
Appearance
| Extensions | none (directory with cur, new, tmp) |
|---|---|
| On this wiki | Facts · Code · Notes · Topics |
Directory mail store with one file per message in tmp/, new/ and cur/; flags live in a ':2,' suffix of the file name in cur/ (F flagged, R replied, S seen, T trashed).
A Maildir is a directory holding three subdirectories, tmp, new and cur, with one file per message (an RFC 822 message). Delivery writes to tmp/ and then moves the file into new/; a client that has seen a message moves it to cur/ and appends the info suffix. The facts below are from neomutt's maildir code (GPL-2.0), maildir/message.c and maildir/shared.c.
File names and the info suffix
- The name of a message in
cur/is<base name>:2,<flags>. neomutt's own base names look like<unix time>.R<random>.<short host name>(maildir_commit_message). Other programs use other base names (for instance withM,P,Qfields, as seen in a Thunderbird sample); the base name may contain commas. - The field delimiter is a colon by default but neomutt allows a different one (config maildir_field_delimiter), because
:is not allowed on some file systems; the code treats it as a single configurable character. - Flags are letters, sorted:
Fflagged,Rreplied,Sseen (read),Ttrashed (deleted); other letters (for example D draft or P passed from the Maildir spec) are kept as custom flags. Unverified: letter D and P meanings, taken from the Maildir specification, not read in this code. - The code comment says the specification requires every file in
cur/to have the:2,string, even with no flags. maildir_canon_filenamestrips the info suffix: it cuts the name at the first,or delimiter, so the canonical name is the unique base name.
Reading tips
new/holds unseen mail; moving it tocur/is how a client marks it seen. File modification time is often set to the received time (neomutt sets it with utime).- Client indexes (for example Thunderbird's .msf, see Format:Thunderbird MSF (Mork)) store the file name in
cur/as the message token; the suffix changes when flags change. - Compare Format:mbox. See Technique:Identifying mail and message stores.
Code & repositories
- https://github.com/neomutt/neomutt @
897cc57b36af55a6c13ec718cd3c95c39391bf6f· license: GPL-2.0-or-later (declared by the contributor for the files used; GitHub reports GPL-2.0 for the repository)
NeoMutt mail client: mbox/mbox.c parses mbox and MMDF folders, maildir/message.c builds and parses Maildir flags, docs/mbox.5 and docs/mmdf.5 describe the formats.
Tested on: source read, not run · checked 2026-10-19; last activity 2026-10-19