Provided by: getlive_2.4+cvs20120801-1_all bug


       getlive - fetch mail from your Hotmail Live account


       getlive --config-file FILE [--verbosity 0..100]

       getlive --port port [--verbosity 0..100]


       getlive is a utility that fetches mail from your Hotmail/Windows Live account. The mail is
       then presented to any filter (typically procmail) for further processing or dropping in  a
       local mailbox.

       There  is  a second mode of operation (indicated by the --port option), that makes getlive
       work as a no-configuration POP3 server that relays requests to Hotmail.


              The format for this file is listed below.

       --port This option enables  the  "FreePops"  mode.  In  this  mode,  no  configuration  is
              necessary,  and  getlive  starts  a  POP3  server  on  the port specified.  See the
              FREEPOPS MODE section for more information.

              Higher number corresponds to greater output as command runs.


       The configuration file takes arguments of the form option = value.  Empty lines  or  lines
       commented with # are allowed.

              Your Hotmail username, excluding the at-sign and domain.

              Your  account  password,  you  should restrict access to your configuration file to
              avoid this information being read by other users.

       Domain The domain for your account, defaults to

       Proxy  Hostname of proxy, if applicable.

              Password for proxy, if applicable.

              File that keeps track of IDs of messages that were  fetched  already.   Default  is

              If  Yes only messages that are marked unread are fetched. If set to Yes, Downloaded
              is ignored.  Defaults to No.

              Number of times to retry fetching a web page via curl. Defaults to 2.

              Command for curl.  Default is "curl -k".

              Any command taking the message in mbox format on its stdin and doing something with
              it.  Default is /usr/bin/procmail.

              · "/bin/cat - >> FetchedMail" might be used to drop directly in a mbox file.

              · The distribution contains also /usr/share/doc/getlive/examples/ and
                /usr/share/doc/getlive/examples/ These can be used  to  forward
                the messages to an SMTP server.

       Folder Folder  that needs to be fetched.  This option must be repeated for each folder you
              want to fetch. If this option is not present then all folders will be fetched.

              Whether the message will be marked  read  after  being  downloaded.   Note  that  a
              message never gets marked in any way if it's not downloaded due to it being already
              in the Downloaded file.  Defaults to No.

       Delete Whether the message will be deleted after being downloaded.  Note  that  a  message
              never gets deleted if it's not downloaded due to it being already in the Downloaded
              file.  Defaults to No.

              Folder to which the message must be moved after being downloaded.  If this argument
              takes  the  form  @FileName  then the folder name is taken from the contents of the

              This can be used, for example, to enable a spam filter to decide to what folder the
              message must be moved. That spamfilter would be invoked by the Processor option and
              then write a folder name (for  instance  Junk  if  considered  junk)  to  the  file

              Note  that a message is not moved if it's not downloaded due to it being already in
              the Downloaded file.

              Whether the Trash folder handling will be skipped or not.  Defaults to No.

              Number of consecutive already downloaded messages after which the search will stop.
              Useful to avoid slowness on extremely large Downloaded files.


       When using this mode, the configuration is ignored, and all configuration values are taken
       from the username used to connect to the POP3 server.

       The format for the username is as follows:[?Option=Value][&Option=Value][&Option=Value]

       With Option=Value pairs from:

              folder="FolderName" : The folder as displayed in hotmail for the folder you want to
              interact with. Defaults to Inbox.

              folderid=N: the folderid you want to interact with:
                1: Inbox
                2: Trash
                3: Sent
                5: Junk

              markread=1: It will mark mails as read on your hotmail account if you read them via
              the the Pop3 Server.

       Note that if your mail client is configured to delete  messages  after  download,  getlive
       will delete them from Hotmail.

       The password passed to the POP3 server will be used to authenticate with Hotmail.


       getlive was written by Jos De Laender <>.

       This  manual  page  was adapted by Tyler Trafford <> and Martin Ferrari
       <> from the included Manual, for the Debian project (but may be  used  by

                                          August 1, 2012                               GETLIVE(1)