.Dd June  5, 2021
.Dt IMBOX 1
.Os
.
.Sh NAME
.Nm imbox
.Nd IMAP to mbox
.
.Sh SYNOPSIS
.Nm
.Op Fl HUisvw
.Op Fl C Ar cc
.Op Fl F Ar from
.Op Fl M Ar mailbox
.Op Fl S Ar subject
.Op Fl T Ar to
.Op Fl h Ar host
.Op Fl m Ar mailbox
.Op Fl p Ar port
.Ar user
.
.Sh DESCRIPTION
The
.Nm
utility exports messages from an IMAP mailbox
to the mboxrd format on standard output.
Messages matching the criteria set by
.Fl CFSTU
are exported.
.
.Pp
IMAP over TLS without STARTTLS is assumed.
IMAP login is performed as
.Ar user
with a password read from
.Pa /dev/tty ,
or standard input if
.Fl w
is used.
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl C Ar cc
Export messages with matching
.Cm Cc
headers.
.
.It Fl F Ar from
Export messages with matching
.Cm From
headers.
.
.It Fl H
Export only the message headers.
.
.It Fl M Ar mailbox
Move matching messages to
.Ar mailbox
after exporting them.
.
.It Fl S Ar subject
Export messages with matching
.Cm Subject
headers.
.
.It Fl T Ar to
Export messages with matching
.Cm To
headers.
.
.It Fl U
Export only unseen messages.
.
.It Fl h Ar host
Connect to IMAP on
.Ar host .
The default host is determined by SRV record lookup
on the domain name of
.Ar user ,
or simply the domain name
if no SRV record exists.
.
.It Fl i
If no messages initially match the criteria,
wait for new messages using IMAP IDLE.
.
.It Fl m Ar mailbox
Export messages from
.Ar mailbox .
The default mailbox is INBOX.
.
.It Fl p Ar port
Connect to IMAP on
.Ar port .
If the
.Fl h
option is used,
the default port is
.Cm imaps
(993).
Otherwise,
the port is determined in the same fashion as the host.
.
.It Fl s
Mark exported messages as seen.
.
.It Fl v
Log IMAP protocol to standard error.
.
.It Fl w
Read the password from standard input.
.El
.
.Sh EXAMPLES
.Bd -literal
imbox -T list+imbox@causal.agency june@causal.agency
.Ed
.
.Sh SEE ALSO
.Xr git-am 1 ,
.Xr git-fetch-email 1
.
.Sh STANDARDS
.Bl -item
.It
.Rs
.%A M. Crispin
.%T INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1
.%I IETF
.%R RFC 3501
.%U https://tools.ietf.org/html/rfc3501
.%D March 2003
.Re
.It
.Rs
.%A L. Esibov
.%A A. Gulbrandsen
.%A P. Vixie
.%T A DNS RR for specifying the location of services (DNS SRV)
.%I IETF
.%R RFC 2782
.%U https://tools.ietf.org/html/rfc2782
.%D February 2000
.Re
.It
.Rs
.%A A. Gulbrandsen
.%T Internet Message Access Protocol (IMAP) - MOVE Extension
.%I IETF
.%R RFC 6851
.%U https://tools.ietf.org/html/rfc6851
.%D January 2013
.Re
.It
.Rs
.%A E. Hall
.%T The application/mbox Media Type
.%I IETF
.%R RFC 4155
.%U https://tools.ietf.org/html/rfc4155
.%D September 2005
.Re
.It
.Rs
.%A P. Mockapetris
.%T DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION
.%I IETF
.%R RFC 1035
.%U https://tools.ietf.org/html/rfc1035
.%D November 1987
.Re
.El
.
.Sh AUTHORS
.An June McEnroe Aq Mt june@causal.agency
.
.Sh BUGS
Send mail to
.Aq Mt list+imbox@causal.agency
or join
.Li #ascii.town
on
.Li irc.tilde.chat .