getlive(1)
NAME
getlive - fetch mail from your Hotmail Live account
SYNOPSIS
getlive [--config-file FILE] [--verbosity 0..100]
DESCRIPTION
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.
OPTIONS
- --config-file
- Default is ${HOME}/.getliverc. The format for this file is listed below.
- --verbosity
- Higher number corresponds to greater output as command runs.
CONFIGURATION FILE
The configuration file takes arguments of the form option = value.
Empty lines or lines commented with # are allowed.
- UserName
- Your Hotmail username, excluding the at-sign and domain.
- Domain The domain for your account, defaults to hotmail.com.
- Mode Compatibility mode: 200809 (default) or 200810. 200810 needs to
- be used for changes that are being rolled out in the hotmail service as of october 2008.
- Password
- Your account password, you should restrict access to your configuration file to avoid this information being read by other users.
- Proxy Hostname of proxy, if applicable.
- ProxyAuth
- Password for proxy, if applicable.
- Downloaded
- File that keeps track of IDs of messages that were fetched already. Default is ${HOME}/.getlive.log.
- FetchOnlyUnread
- If Yes only messages that are marked unread are fetched. If set to Yes, Downloaded is ignored. Defaults to No.
- RetryLimit
- Number of times to retry fetching a web page via curl. Defaults to 2.
- CurlBin
- Command for curl. Default is "curl -k".
- Processor
- 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/exam
ples/SmtpForward.pl and /usr/share/doc/getlive/examples/SmtpAuthForward.pl 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.
- MarkRead
- 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.
- MoveToFolder
- 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 file.
- 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 FileName.
- Note that a message is not moved if it's not downloaded due to it being already in the Downloaded file.
- SkipTrash
- Whether the Trash folder handling will be skipped or not. Defaults to No.
AUTHOR
getlive was written by Jos De Laender <jos.de_laender@pandora.be>.
- This manual page was adapted by Tyler Trafford <ttrafford@gmail.com>
and Martin Ferrari <tincho@debian.org> from the included Manual, for
the Debian project (but may be used by others).