Changes between Version 2 and Version 3 of MuttGuide/UseIMAP


Ignore:
Timestamp:
May 18, 2013 3:10:40 PM (5 years ago)
Author:
mpacey
Comment:

Make the muttrcs actual muttrcs, describe the format of the URL explicitly, and explain authentication options.

Legend:

Unmodified
Added
Removed
Modified
  • MuttGuide/UseIMAP

    v2 v3  
    1 To use IMAP with mutt, here's a sample ~/.muttrc file:
     1To use IMAP with mutt, set {{{spoolfile}}} to an [http://tools.ietf.org/html/rfc5092 IMAP URL] of the form:
     2
    23{{{
    3  # Automatically log in to this mailbox at startup
    4  set spoolfile="imap''[s]''://''[<username>['':''<optional_password>]''@'']''<server>/INBOX"
    5  # Define the = shortcut, and the entry point for the folder browser (c?)
    6  set folder="imap''[s]''://''[<username>''@'']''<server>/INBOX"
    7  set record="=Sent"
    8  set postponed="=Drafts"
     4imap[s]://[<username>[:<password>]@]<server>/[<mailbox>]
    95}}}
    106
    11 The above config works for people who have subfolders below (inside/nested) the INBOX folder. If you have folders at the same level (flat) as your INBOX folder, remove the trailing INBOX from the spoolfile and folder directives:
     7If your folders are addressed as sub-folders of your INBOX folder, {{{INBOX}}} should be given as the {{{mailbox}}} component, otherwise leave it empty. If you omit {{{password}}}, or indeed {{{username}}}, mutt will prompt for this on startup.
     8
     9You should also set {{{folder}}} to a similar IMAP URL, however there is no need for authentication information here.
     10
     11Here's a sample {{{~/.muttrc}}} file, for a user johndoe with the INBOX sub-folder setup on a server mail.example.com:
    1212
    1313{{{
    14  # Automatically log in to this mailbox at startup
    15  set spoolfile="imap''(s)''://''[<username>['':''<optional_password>]''@'']''<server>/"
    16  # Define the = shortcut, and the entry point for the folder browser (c?)
    17  set folder="imap''(s)''://''[<username>''@'']''<server>/"
    18  set record="=Sent"
    19  set postponed="=Drafts"
     14# Automatically log in to this mailbox at startup
     15set spoolfile="imaps://johndoe:p455w0rd@mail.example.com/INBOX"
     16# Define the = shortcut, and the entry point for the folder browser (c?)
     17set folder="imaps://mail.example.com/INBOX"
     18set record="=Sent"
     19set postponed="=Drafts"
     20}}}
     21
     22And here's a sample {{{~/.muttrc}}} for a user jane at another site, this time without the INBOX sub-folder setup. Jane is prompted for her password at startup:
     23
     24{{{
     25# Automatically log in to this mailbox at startup
     26set spoolfile="imaps://jane@mail.demo.com/"
     27# Define the = shortcut, and the entry point for the folder browser (c?)
     28set folder="imaps://mail.example.com/"
     29set record="=Sent"
     30set postponed="=Drafts"
    2031}}}
    2132