1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
|
Requirements
You need to have the below installed to be able to use FetchYahoo effectively.
* A mail client that can read from a mail spool or an mbox-formatted file
(almost all Unix mail clients, Netscape Mail for Windows)
* A working installation of Perl (comes with almost all Unix installations
, needs to be installed for Windows - try ActivePerl
( http://www.activestate.com/Products/Download/Get.plex?id=ActivePerl&a=e )
* Several Perl modules are required. The following module-collections
contain the required modules: libwww-perl, html-parser, MIME-tools,
libnet (for mail forwarding), Crypt-SSLeay (for https). Some users
report additionally requiring the following: URI, MailTools, IO-stringy,
MIME-Base64. There are several methods for getting these :
o If you have an RPM-based distribution, search at RPMfind.net
( http://rpmfind.net/linux/RPM/ ) for
perl-MIME-tools, perl-html-parser, perl-libwww-perl, perl-libnet
(for mail forwarding) and perl-Crypt-SSLeay (for https) and get
the required RPMs for your distribution
o For deb-based systems (properly configured), you can just do
"apt-get -u install libnet libhtml-parser-perl libmime-perl
libwww-perl libcrypt-ssleay-perl"
o For windows, you can use the Perl Package Manager which comes with
ActivePerl
o If you have the CPAN perl module installed and working you can
run "perl -MCPAN -e shell" and then install each of the following
separately: HTML::Entities, LWP::UserAgent, MIME::Entity,
Net::SMTP (for mail forwarding - use the libnet version),
Crypt::SSLeay (for https)
o Go to the CPAN repository ( http://www.cpan.org/ ). Go to the
first search choice (Perl
core and CPAN modules). Search for MIME-tools, libwww-perl,
html-parser, libnet (for mail forwarding) and Net_SSLeay
(for https). Follow the appropriate installation instructions.
Usage notes
* Download the package and uncompress it (tar -xvzf fetchyahoo-x.y.tar.gz)
* cd fetchyahoo-x.y ; chmod a+rx fetchyahoo
* Edit fetchyahoo
OR copy fetchyahoorc to /etc/fetchyahoorc or ~/.fetchyahoorc and edit that
OR just run fetchyahoo from the commandline
(use --help to see all options). A list of options is at the end.
* Use your mail client to get mail from your spool or mbox file
* optionally use cron or gkrellm ( http://www.gkrellm.net/ )
to download messages periodically
* e-mail author ( ravi_ramkissoon AT yahoo.com) with bugs and feature
requests
NB: Options specified on the commandline take precedence over options
specified in the configuration file, which in turn take precedence over
options hardcoded within the fetchyahoo program file. Note the useHTTPS
option to use SSL to connect securely !
Procmail instructions
* use "/path/to/procmail" as your mail spool name
* set spoolMode to "pipe"
* if you want procmail to send mail to your local MTA use the following in
your .procmailrc - ":0<return>! yourlocaluser@localhost"
Windows Instructions
This is reported to work fine under Windows (thanks to Shiraz Kanga for
pointing this out). It works with the Netscape mail client which uses the mbox
format (output by FetchYahoo) for its local folders. If you know of any other
Windows mail clients which will work, please tell me.
* Download Perl for Windows (e.g. ActivePerl -
http://www.activestate.com/Products/Download/Get.plex?id=ActivePerl&a=e )
* Edit fetchyahoo or the configuration file as shown above
* Use Netscape Mail to get your mail from the mailbox you specified
* e-mail author (ravi_ramkissoon AT yahoo.com) with bugs and feature
requests
If you do not use Netscape Mail, you can try the following methods (these are
untested):
* For Eudora specify a new or existing Eudora mailbox as the spool file.
* For Outlook or Outlook Express, specify a temporary (existent but empty)
file as the spool file, and then after fetchyahoo has completed, choose
File -> Import -> Messages from Outlook (or Outlook Express) and choose the
temporary file you specified. This has been tested successfully.
Commandline Options
--version print the version and exit
--help display help showing the program options
--quiet suppress regular (non-error) messages
--noerrors suppress error messages
--listmessages list messages in mail folder
--onlylistmessages only list messages in mail folder. This combines
--listmessages, --nodownload and --nodelete
--configfile=config-file use config-file as the configuration file
--username=yahoousername use yahoousername as the login
--password=pass use pass as the password. pass can also be an
md5_hex hashed password.
--spoolfile=spool-file use spool-file as the file to spool messages to
if spool-file ends with / it is treated as a
maildir format directory
--folder=folder-name download messages from folder-name instead
--nohttps use an insecure plaintext login instead of HTTPS
--newonly only download new (i.e. unread) messages
--nodelete do not delete messages after downloading them
--nodownload do not download messages
(but still delete them/empty trash if requested)
--append append messages to spool-file (default)
--overwrite overwrite spool-file (instead of appending)
--pipe pipe messages to a program instead of
a spool-file
--emptytrashbefore empty trash before downloading messages
--emptytrashafter empty trash after downloading messages
--emptybulk empty bulk mail folder (always before fetch)
--leaveunread leave messages unread on the server
--repeatinterval=N check for mail every N minutes (daemon mode)
--statusonly only get number of messages
--getexternal retrieve messages from external mailboxes also
--maxmessages=N download at most N messages in one run
setting this to over 100 may cause problems
[DEFAULT 100]
--maxsize=N do not download any msg larger than N kB
setting to 0 will turn off this check
[DEFAULT 0]
--warninglevel=N warn if the server mailbox is >= N% full
setting to 0 will turn off the warning
[DEFAULT 0]
--nofromline leave out the leading From_ line
--logout log out of Yahoo! when done
--md5hex print the MD5 hex hash value of a password
entered interactively (can be used instead of
password in configuration files)
--proxyhost=proxy.host.org hostname for proxy [ DEFAULT off ]
--proxyport=N port for proxy [DEFAULT 80 ]
--proxyuser=proxy-user username for proxy authentication[ DEFAULT none]
--proxypass=proxy-pass password for proxy authentication[ DEFAULT none]
--imaphost=imap.host.org hostname of IMAP sever [ DEFAULT off ]
--imapport=N port for IMAP server [DEFAULT 143 ]
--imapuser=imap-user username for IMAP authentication[ DEFAULT none]
--imappass=imap-pass password for IMAP authentication[ DEFAULT none]
--imapmailbox=imap-mailbox IMAP mailbox [ DEFAULT INBOX]
--noquiet opposite of --quiet [DEFAULT]
--errors opposite of --noerrors [DEFAULT]
--delete opposite of --nodelete [DEFAULT]
--nolistmessages opposite of --listmessages [DEFAULT]
--nologout opposite of --logout [DEFAULT]
--noempty do not empty trash or bulk [DEFAULT]
--allmsgs get all msgs (not only new ones) [DEFAULT]
--download opposite of --nodownload [DEFAULT]
--includefromline opposite of --nofromline [ DEFAULT ]
--markread opposite of --leaveunread [ DEFAULT ]
--nostatusonly opposite of --statusonly [ DEFAULT ]
--nogetexternal opposite of --getexternal [ DEFAULT ]
--https use a secure login via HTTPS [ DEFAULT ]
--version print the version and exit
--help display help showing the program options
--quiet suppress regular (non-error) messages
--noerrors suppress error messages
--listmessages list messages in mail folder
--onlylistmessages only list messages in mail folder. This combines
--listmessages, --nodownload and --nodelete
--configfile=config-file use config-file as the configuration file
--username=yahoousername use yahoousername as the login
--password=pass use pass as the password. pass can also be an
md5_hex hashed password.
--spoolfile=spool-file use spool-file as the file to spool messages to
if spool-file ends with / it is treated as a
maildir format directory
--folder=folder-name download messages from folder-name instead
--nohttps use an insecure plaintext login instead of HTTPS
--newonly only download new (i.e. unread) messages
--nodelete do not delete messages after downloading them
--nodownload do not download messages
(but still delete them/empty trash if requested)
--append append messages to spool-file (default)
--overwrite overwrite spool-file (instead of appending)
--pipe pipe messages to a program instead of
a spool-file
--msgidarchivefile=file-name save message IDs to this file and do not download
messages whose IDs have been saved to this file
--emptytrashbefore empty trash before downloading messages
--emptytrashafter empty trash after downloading messages
--emptybulk empty bulk mail folder (always before fetch)
--leaveunread leave messages unread on the server
--repeatinterval=N check for mail every N minutes (daemon mode)
--statusonly only get number of messages
--getexternal retrieve messages from external mailboxes also
--maxmessages=N download at most N messages in one run
setting this to over 90 may cause problems
[DEFAULT 90]
--maxsize=N do not download any msg larger than N kB
setting to 0 will turn off this check
[DEFAULT 0]
--warninglevel=N warn if the server mailbox is >= N% full
setting to 0 will turn off the warning
[DEFAULT 0]
--nofromline leave out the leading From_ line
--logout log out of Yahoo! when done
--md5hex print the MD5 hex hash value of a password
entered interactively (can be used instead of
password in configuration files)
--proxyhost=proxy.host.org hostname for proxy [ DEFAULT off ]
--proxyport=N port for proxy [DEFAULT 80 ]
--proxyuser=proxy-user username for proxy authentication[ DEFAULT none]
--proxypass=proxy-pass password for proxy authentication[ DEFAULT none]
--imaphost=imap.host.org hostname of IMAP sever [ DEFAULT off ]
--imapport=N port for IMAP server [DEFAULT 143 ]
--imapuser=imap-user username for IMAP authentication[ DEFAULT none]
--imappass=imap-pass password for IMAP authentication[ DEFAULT none]
--imapmailbox=imap-mailbox IMAP mailbox [ DEFAULT INBOX]
--noquiet opposite of --quiet [DEFAULT]
--errors opposite of --noerrors [DEFAULT]
--delete opposite of --nodelete [DEFAULT]
--nolistmessages opposite of --listmessages [DEFAULT]
--nologout opposite of --logout [DEFAULT]
--noempty do not empty trash or bulk [DEFAULT]
--allmsgs get all msgs (not only new ones) [DEFAULT]
--download opposite of --nodownload [DEFAULT]
--includefromline opposite of --nofromline [ DEFAULT ]
--markread opposite of --leaveunread [ DEFAULT ]
--nostatusonly opposite of --statusonly [ DEFAULT ]
--nogetexternal opposite of --getexternal [ DEFAULT ]
--https use a secure login via HTTPS [ DEFAULT ]
--version print the version and exit
--help display help showing the program options
--quiet suppress regular (non-error) messages
--noerrors suppress error messages
--debug turn on normal and debugging output
--listmessages list messages in mail folder
--onlylistmessages only list messages in mail folder. This combines
--listmessages, --nodownload and --nodelete
--configfile=config-file use config-file as the configuration file
--username=yahoousername use yahoousername as the login
--password=pass use pass as the password. pass can also be an
md5_hex hashed password.
--spoolfile=spool-file use spool-file as the file to spool messages to
if spool-file ends with / it is treated as a
maildir format directory
--folders=folder1,folder2 download messages from one or more folders instead
--nohttps use an insecure plaintext login instead of HTTPS
--newonly only download new (i.e. unread) messages
--nodelete do not delete messages after downloading them
--nodownload do not download messages
(but still delete them/empty trash if requested)
--safedownload sleep a few seconds between messages. This
disables use of maxmessages and takes much
longer to download messages but should prevent
throttling by Yahoo
--append append messages to spool-file (default)
--overwrite overwrite spool-file (instead of appending)
--pipe pipe messages to a program instead of
a spool-file
--msgidarchivefile=file-name save message IDs to this file and do not download
messages whose IDs have been saved to this file
--archivefolder=folder-name move messages to this Yahoo folder
--sendto=emailaddress1,email2 list of e-mail address to forward e-mails to
--mailhost=smtp.example.com smtp outgoing mail server to use to send mail
--sendfrom=fromaddress e-mail address to use as the from address
--smtpusername=username username for SMTP authentication
--smtppassword=password password for SMTP authentication
--emptytrash empty trash before downloading messages
--emptytrashbefore empty trash before downloading messages
--emptytrashafter empty trash after downloading messages
--emptybulk empty bulk mail folder (always before fetch)
--leaveunread leave messages unread on the server
--repeatinterval=N check for mail every N minutes (daemon mode)
--statusonly only get number of messages
--getexternal retrieve messages from external mailboxes also
--externalmailboxes=boxes,list retrieve messages from only this comma-separated
list of external mailboxes
--maxmessages=N download at most N messages in one run
setting this to over 90 may cause problems
[DEFAULT 90]
--maxsize=N do not download any msg larger than N kB
setting to 0 will turn off this check
[DEFAULT 0]
--warninglevel=N warn if the server mailbox is >= N% full
setting to 0 will turn off the warning
[DEFAULT 0]
--nofromline leave out the leading From_ line
--logout log out of Yahoo! when done
--md5hex print the MD5 hex hash value of a password
entered interactively (can be used instead of
password in configuration files)
--proxyhost=proxy.host.org hostname for proxy [ DEFAULT off ]
--proxyport=N port for proxy [DEFAULT 80 ]
--proxyuser=proxy-user username for proxy authentication[ DEFAULT none]
--proxypass=proxy-pass password for proxy authentication[ DEFAULT none]
--imaphost=imap.host.org hostname of IMAP sever [ DEFAULT off ]
--imapport=N port for IMAP server [DEFAULT 143 ]
--imapuser=imap-user username for IMAP authentication[ DEFAULT none]
--imappass=imap-pass password for IMAP authentication[ DEFAULT none]
--imapmailbox=imap-mailbox IMAP mailbox [ DEFAULT INBOX]
--secureimap use secure IMAP (IMAPS) [ DEFAULT off ]
--noquiet opposite of --quiet [DEFAULT]
--errors opposite of --noerrors [DEFAULT]
--delete opposite of --nodelete [DEFAULT]
--nodebug opposite of --nodebug [DEFAULT]
--nolistmessages opposite of --listmessages [DEFAULT]
--nologout opposite of --logout [DEFAULT]
--noempty do not empty trash or bulk [DEFAULT]
--allmsgs get all msgs (not only new ones) [DEFAULT]
--download opposite of --nodownload [DEFAULT]
--includefromline opposite of --nofromline [ DEFAULT ]
--markread opposite of --leaveunread [ DEFAULT ]
--nostatusonly opposite of --statusonly [ DEFAULT ]
--nogetexternal opposite of --getexternal [ DEFAULT ]
--nosafedownload opposite of --safedownload [ DEFAULT ]
--https use a secure login via HTTPS [ DEFAULT ]
--cookiefile=filename read/save cookies from/to file [DEFAULT none]
--nosecureimap do not use secure IMAP (IMAPS) [ DEFAULT ]
|
