.Dd April 10, 2020 .Dt BUBGER 1 .Os . .Sh NAME .Nm bubger .Nd IMAP archive renderer . .Sh SYNOPSIS .Nm .Op Fl v .Op Fl C Ar path .Op Fl a Ar algo .Op Fl h Ar head .Op Fl p Ar port .Op Fl s Ar search .Op Fl t Ar title .Op Fl w Ar file .Ar host .Ar user .Op Ar mailbox . .Sh DESCRIPTION The .Nm utility renders an HTML, Atom and mboxrd archive of an IMAP mailbox arranged into threads. . .Pp The arguments are as follows: . .Bl -tag -width Ds .It Fl C Ar path Change directory to .Ar path before reading and writing files. . .It Fl a Ar algo Set the threading algorithm to one of .Sy ORDEREDSUBJECT or .Sy REFERENCES . The default algorithm is .Sy REFERENCES . . .It Fl h Ar head Add the contents of the file .Ar head to the .Sy element of HTML pages. . .It Fl p Ar port Connect to IMAP on .Ar port . The default port is .Sy imaps .Pq 993 . TLS without STARTTLS is assumed. . .It Fl s Ar search Limit threads to messages matching .Ar search . The default search is .Sy ALL . . .It Fl t Ar title Set the base title for HTML pages. The default title is the mailbox name. . .It Fl w Ar file Read the IMAP password from .Ar file . By default the password is set by the .Ev BUBGER_IMAP_PASSWORD environment variable. . .It Fl v Log IMAP protocol to standard error. . .It Ar host Connect to IMAP on .Ar host . .It Ar user Log in to IMAP as .Ar user . . .It Ar mailbox Render messages from .Ar mailbox . The default mailbox is .Qq Archive . .El . .Sh ENVIRONMENT .Bl -tag -width Ds .It Ev BUBGER_IMAP_PASSWORD The IMAP password. .El . .Sh FILES .Bl -tag -width Ds .It Pa UIDVALIDITY Stores the mailbox UID validity. .It Pa UIDNEXT Stores the next UID of the mailbox. .It Pa UID/*.atom , Pa UID/*.html , Pa UID/*.mbox Cached Atom, HTML and mboxrd fragments for each message. .It Pa message/*.mbox Rendered mboxrd files for each message. .It Pa thread/*.atom , Pa thread/*.html , Pa thread/*.mbox Rendered Atom, HTML and mboxrd files for each thread. .El . .Sh STANDARDS .Bl -item .It .Rs .%A M. Crispin .%T INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1 .%I IETF .%N RFC 3501 .%D March 2003 .%U https://tools.ietf.org/html/rfc3501 .Re .It .Rs .%A M. Crispin .%A K. Murchison .%T Internet Message Access Protocol - SORT and THREAD Extensions .%I IETF .%N RFC 5256 .%D June 2008 .%U https://tools.ietf.org/html/rfc5256 .Re .It .Rs .%A M. Nottingham .%A R. Sayre .%T The Atom Syndication Format .%I IETF .%N RFC 4287 .%D December 2005 .%U https://tools.ietf.org/html/rfc4287 .Re .It .Rs .%A T. Berners-Lee .%A L. Masinter .%A M. McCahill .%T Uniform Resource Locators (URL) .%I IETF .%N RFC 1738 .%D December 1994 .%U https://tools.ietf.org/html/rfc1738 .Re .El . .Sh AUTHORS .An June Bug Aq Mt june@causal.agency