# FetchYahoo configuration file

# values in this file override values specified in the script itself
# but are in turn overridden by values specified on the commandline
# lines starting with # are ignored
# do NOT use any quotes around values
# values can include whitespace, but not at the end.

###### SHOULD configure these  ######
username = yahoo-user-name
# this can be a password or an md5_hex hashed password
password = yahoo-password

# set this to 0 to turn off HTTPS and login insecurely via plaintext instead
use-https = 1

###### mail spool, mbox file and procmail configs ######

# set use-spool to 0 to disable outputting to a file/filter
use-spool = 1
# if spoolName ends with a / we output in maildir format to that directory
spool = /var/spool/mail/local-user-name

# spool-mode must be either append, pipe or overwrite
# use pipe for procmail or other filter and append for a normal spool
# ignored if spoolName is a maildir directory
spool-mode = append

# set the below to 1 to remember which messages were downloaded and not
# download them again - especially useful with the leaveUnread option
use-msg-id-archive = 0
msg-id-archive-file=/path/to/file-to-store-msg-ids

# set the below to 1 to move messages to a folder to archive them
# this is very useful with Yahoo's new increased storage limits
use-archive-folder = 0
archive-folder = Archive-Folder-to-Move-Messages-To

###### proxy configuration ######
# set use-proxy to 1 to enable use of a web proxy
use-proxy = 0
proxy-host = proxy.example.com
proxy-port = 80
proxy-username = proxyAuthenicationUserName
proxy-password = proxyAuthenicationPassword

###### IMAP configuration ######
# set use-imap to 1 to enable output to an IMAP mailbox
use-imap = 0
imap-host = imap.example.com
imap-port = 143
imap-username = imap-user-name
imap-password = imap-password
imap-mailbox = INBOX
# set this to 1 to use secure IMAP (IMAPS)
secure-imap = 0

###### mail forwarding configuration ######
# set use-forward to 1 to enable mail forwarding
use-forward = 0

# set mail-host to your smtp outgoing mail server
mail-host = outgoing.example.com

# to use SMTP authentication, set these to your SMTP username and password
smtp-username = my-smtp-username
smtp-password = my-smtp-password

# the e-mail addresses you want mail forwarded to
send-to = me@example.com , me2@example.com

# the e-mail address used as the from address, this should probably be at the
# same ISP as the outgoing smtp mailhost specified above
send-from = me@example.com

# set this to 1 if you want to use sendmail to deliver messages
use-sendmail = 0
# set this to the location of your sendmail binary if you set the above to 1
sendmail = /usr/sbin/sendmail

###### other configuration ######

# If this is set to 1, then max-messages is ignored and we will sleep for
# a few seconds before downloading every message. This makes downloading much
# slower but should prevent Yahoo from throttling us.
safe-download = 0

# IMPORTANT Yahoo gives trouble when downloading over 400 messages at a time
# Setting this to more than 400 (or 0 for unlimited) may cause problems.
# max number of messages to download in one go.
# setting safe-download to 1 disables use of max-messages.
max-messages = 400

# set no-download to 1 to to not download  messages
# e.g. if this conf file is for removing Bulk Folder msgs without downloading
no-download = 0

# set new-messages-only to 1 to download only unread messages
new-messages-only = 0

# set this to N to not download messages larger than N kb
# setting this to 0 turns off this check
max-size = 0

# set no-delete to 1 to not delete messages after dowloading 
# i.e. they will be left on Yahoo!'s mail servers
no-delete = 0

# set this to the folder you want to download from eg Bulk
# this can also be a comma-separated list of folders
folders = Inbox

# set quiet to 1 to not output any regular (non-error) messages
quiet = 0

# set this to 1 to retrieve messages from external mailboxes too
get-external = 0

# set this to retrieve only this comma-separated list of mail boxes
# external-mail-boxes = boxes,list

# set no-errors to 1 to not output any error messages
no-errors = 0

# list the messages seen in the mail folder
list-messages = 0

# set either of these to 1 to enable mail checking before or after downloading msgs
empty-trash-after = 0
empty-trash-before = 0

# set this to 1 to enable emptying the Bulk folder before fetching messages
empty-bulk = 0

# if this is 0, the program runs once and terminates
# Otherwise this is the number of minutes between successive mail checks.
repeat-interval = 0

# to leave messages as unread on the server, set this to 1
# this is only useful if no-delete is also set to 1
leave-unread = 0

# if you are using a program/filter which does not expect a From_ line
# at the start of the message, set this to 1
no-from-line = 0

# set logout to 1 to make fetchyahoo logout after downloading messages
logout = 0

# set status-only to 1 to only get the number of messages
status-only = 0

# set warning-level to 0 to not warn
# if >0, will print a warning if mailbox is >= N% full
warning-level = 0

# uncomment and fill this in to read/save cookies to/from this file
# cookie-file = /home/username/.fetchyahoo_cookies
