Unix utilities to deal with Maildir
C Shell Ruby Makefile Awk
Switch branches/tags
Clone or download
Permalink
Failed to load latest commit information.
contrib contrib/mp7m: add application/pkcs7-mime decoder Mar 20, 2018
man magrep: add -l flag Jul 8, 2018
t t/1501-maddr-regress.t: fix failing test, maddr never quotes the disp… Mar 2, 2018
.mailmap add .mailmap Jul 3, 2017
.travis.yml add .travis.yml Mar 30, 2017
COPYING Leahize Jan 21, 2017
GNUmakefile mdeliver: add refiling capability Apr 17, 2018
INSTALL.md Add OS X Yosemite to INSTALL.md Jun 24, 2017
NEWS.md NEWS.md: update Feb 13, 2018
README README: update Apr 19, 2018
VERSION Update VERSION Jun 4, 2018
VIOLATIONS.md VIOLATIONS.md: missing MIME-Version Jun 30, 2017
blaze822.c blaze822: compress_hdr: avoid stepping h too far Mar 2, 2018
blaze822.h blaze822.h: ensure PATH_MAX is defined Jan 25, 2018
blaze822_priv.h blaze822: keep a pointer to the original header, if we have it anyway Aug 6, 2016
filter.c style Aug 31, 2017
filter.example filter.example: use mflow Jul 26, 2017
maddr.c whitespace fixes May 23, 2018
magrep.c magrep: add -l flag Jul 8, 2018
mbnc add mbnc to bounce messages Jan 6, 2018
mcolor mcolor: support $NO_COLOR Jan 29, 2018
mcom mcom: detect Attach: headers for automiming Jul 16, 2018
mdate.c mdate: style tweak Sep 1, 2016
mdeliver.c mdeliver: fix stray whitespace Jul 8, 2018
mdirs.c mdirs: use blaze822.h Jan 25, 2018
mexport.c style Aug 31, 2017
mflag.c mflag: fix behavior with no arguments and reading from not a tty Sep 1, 2017
mflow.c mflow: flowed: ensure progress by printing at least one word each time Nov 9, 2017
mgenmid.c use appropriate integer types Oct 6, 2017
mhdr.c whitespace fixes May 23, 2018
minc.c style Aug 31, 2017
mless mless: support $NO_COLOR Jan 29, 2018
mlesskey.example mless: add { }/$ to jump to first/last message Jan 7, 2018
mlist.c mlist: listarg: list empty Maildirs if no filtering took place Jan 1, 2018
mmime.c use appropriate integer types Oct 6, 2017
mmkdir mmkdir: make official command Jun 20, 2017
mnext add mprev/mnext to call mless with appropriate offset Jul 20, 2016
mpick.c mpick: don't allow EXPR_ANYSET with unmatched operator Feb 5, 2018
mprev add mprev/mnext to call mless with appropriate offset Jul 20, 2016
mquote mquote: fall back to rendering when no plaint text reply was found Jan 9, 2018
mrep rename mcomp -> mcom, mrepl -> mrep Aug 8, 2016
mscan.c mscan: u8putstr: factor out common code Jan 11, 2018
msed.c msed: sed: free h and v Jan 11, 2018
mseq.c mseq: create tmpfile O_EXCL to detect multiple mseq -S in a pipeline Jan 6, 2018
mshow.c mshow: add -B to decode MIME parameters in broken mails Apr 17, 2018
msort.c style Aug 31, 2017
mthread.c mthread: thread: fix small leak Jan 11, 2018
mymemmem.c mymemmem: update with patch from musl mailing list Jul 11, 2017
mystrverscmp.c mystrverscmp: fix include Jul 26, 2016
mytimegm.c clean up whitespace Jan 26, 2017
pipeto.c use appropriate integer types Oct 6, 2017
rfc2045.c rfc2045: blaze822_multipart: avoid buffer overflow on empty MIME part Feb 12, 2018
rfc2047.c rfc2047: blaze822_decode_rfc2047: fix memory leak of srcenc Jan 11, 2018
rfc2231.c use appropriate integer types Oct 6, 2017
safe_u8putstr.c revamp utf-8 handling code Nov 22, 2017
seq.c blaze822: blaze822_loop: use long as return type Jan 7, 2018
slurp.c style Aug 31, 2017
squeeze_slash.c mlist: extract squeeze_slash Jul 12, 2017
u8decode.h u8decode: detect invalid encodings Nov 23, 2017

README

MBLAZE(7)              Miscellaneous Information Manual              MBLAZE(7)

NAME
     mblaze – introduction to the mblaze message system

DESCRIPTION
     The mblaze message system is a set of Unix utilities for processing and
     interacting with mail messages which are stored in maildir folders.

     Its design is roughly inspired by MH, the RAND Message Handling System,
     but it is a complete implementation from scratch.

     mblaze consists of these Unix utilities that each do one job:

     maddr(1)     extract mail addresses from messages
     magrep(1)    search messages matching a pattern
     mbnc(1)      bounce messages
     mcom(1)      compose and send messages
     mdeliver(1)  deliver messages or import mbox file
     mdirs(1)     list maildir folders, recursively
     mexport(1)   export messages as mbox file
     mflag(1)     manipulate maildir flags
     mflow(1)     reflow format=flowed plain text messages
     mfwd(1)      forward messages
     mgenmid(1)   generate a Message-ID
     mhdr(1)      print message headers
     minc(1)      incorporate new messages
     mless(1)     conveniently read messages in less(1)
     mlist(1)     list and filter messages
     mmime(1)     create MIME messages
     mmkdir(1)    create new maildir folders
     mpick(1)     advanced message filter
     mrefile(1)   move or copy messages between maildir folders
     mrep(1)      reply to messages
     mscan(1)     generate one-line message summaries
     msed(1)      manipulate message headers
     mseq(1)      manipulate message sequences
     mshow(1)     render messages and extract MIME parts
     msort(1)     sort messages
     mthread(1)   arrange messages into discussions

     mblaze is a classic command line MUA and has no features for receiving or
     transferring messages; you can operate on messages in a local maildir
     spool, or fetch your messages using fdm(1), getmail(1), offlineimap(1),
     or similar utilities, and send it using dma(8), msmtp(1), sendmail(8), as
     provided by OpenSMTPD, Postfix, or similar.

     mblaze operates directly on maildir folders and doesn't use its own
     caches or databases.  There is no setup needed for many uses.  All
     utilities have been written with performance in mind.  Enumeration of all
     messages in a maildir is avoided unless necessary, and then optimized to
     limit syscalls.  Parsing message metadata is optimized to limit I/O
     requests.  Initial operations on a large maildir may feel slow, but as
     soon as they are in the file system cache, everything is blazingly fast.
     The utilities are written to be memory efficient (i.e. not wasteful), but
     whole messages are assumed to fit into RAM easily (one at a time).

     mblaze has been written from scratch and is now well tested, but it is
     not 100% RFC-conforming (which is neither worth it, nor desirable).
     There may be issues with very old, nonconforming, messages.

     mblaze is written in portable C, using only POSIX functions (apart from a
     tiny Linux-only optimization), and has no external dependencies.  It
     supports MIME and more than 7-bit messages (everything the host iconv(3)
     can decode).  It assumes you work in a UTF-8 environment.  mblaze works
     well with other Unix utilities such as mairix(1), mu(1), or
     offlineimap(1).

EXAMPLES
     mblaze utilities are designed to be composed together in a pipe.  They
     are suitable for interactive use and for scripting, and integrate well
     into a Unix workflow.

     For example, you could decide you want to look at all unseen messages in
     your INBOX, oldest first.
           mlist -s ~/Maildir/INBOX | msort -d | mscan

     To operate on a set of messages in multiple steps, you can save it as a
     sequence, e.g. add a call to ‘mseq -S’ to the above command:
           mlist -s ~/Maildir/INBOX | msort -d | mseq -S | mscan

     Now mscan will show message numbers and you could look at the first five
     messages at once, for example:
           mshow 1:5

     Likewise, you could decide to incorporate (by moving from new to cur) all
     new messages in all folders, thread it and look at it interactively:
           mdirs ~/Maildir | xargs minc | mthread | mless

     Or you could list the attachments of the 20 largest messages in your
     INBOX:
           mlist ~/Maildir/INBOX | msort -S | tail -20 | mshow -t

     Or apply the patches from the current message:
           mshow -O. '*.diff' | patch

     As usual with pipes, the sky is the limit.

CONCEPTS
     mblaze deals with messages (which are files), folders (which are maildir
     folders), sequences (which are newline-separated lists of messages,
     possibly saved on disk in ${MBLAZE:-$HOME/.mblaze}/seq), and the current
     message (kept as a symlink in ${MBLAZE:-$HOME/.mblaze}/cur).

     Messages in the saved sequence can be referred to using special syntax as
     explained in mmsg(7).

     Many utilities have a default behavior when used interactively from a
     terminal (e.g. operate on the current message or the current sequence).
     For scripting, you must make these arguments explicit.

     For configuration, see mblaze-profile(5).

SEE ALSO
     mailx(1), mblaze-profile(5), nmh(7)

AUTHORS
     Leah Neukirchen <leah@vuxu.org>

     There is a mailing list available at mblaze@googlegroups.com (to
     subscribe, send a message to mblaze+subscribe@googlegroups.com) and an
     IRC channel #vuxu on irc.freenode.net.  Please report security-related
     bugs directly to the author.

LICENSE
     mblaze is in the public domain.

     To the extent possible under law, the creator of this work has waived all
     copyright and related or neighboring rights to this work.

           http://creativecommons.org/publicdomain/zero/1.0/

Void Linux                      January 6, 2018                     Void Linux