Attachment 60566 Details for Bug 24325 – yosucker-r1.xml

yosucker-r1.xml

yosucker.xml (text/plain), 8.33 KB, created by Curtis Napier (RETIRED) on 2005-06-04 03:04:20 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Curtis Napier (RETIRED)

Created: 2005-06-04 03:04:20 UTC

Size: 8.33 KB

patch

obsolete

><?xml version="1.0" encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="/yosucker.xml">
><title>YoSucker</title>
><author title="Author">
>  <mail link="curtis119@yahoo.com">M Curtis Napier</mail>
></author>
>
><abstract>
>This guide explains how to install and configure YoSucker, a Mail User Agent, 
>designed to access your Yahoo Mail account through the http interface and 
>download mails to your local machine.
></abstract>
>
>
>
><license/>
>
><version>1.0</version>
><date>2005-06-03</date>
>
><chapter>
><title>YoSucker</title>
><section>
><title>Introduction</title>
><body>
>
><p>
>This guide explains how to install and configure YoSucker, a Mail User Agent, 
>designed to access your Yahoo Mail account through the http interface and 
>download mails to your local machine in various formats. 
></p>
>
></body>
></section>
><section>
><title>How YoSucker works</title>
><body>
>
><p>
>YoSucker is a PERL script that accesses the <path>http://mail.yahoo.com</path> 
>website and then performs the user actions of clicking buttons and filling in 
>the User/Pass. This bypasses any file format changes that Yahoo may do. Other 
>Yahoo mail apps access the Yahoo Mail Inbox directly, this method can and 
>has been blocked by Yahoo in the past. YoSucker can retrieve mail to your local inbox
> in a variety of formats that will be covered below. YoSucker supports multiple 
>accounts, procmail, localised Yahoo Mail sites, proxy connections and more.
></p>
>
></body>
></section>
><section>
><title>Install</title>
><body>
>
><p>
>YoSucker depends on the following packages:
></p>
>
><ul>
>  <li>dev-lang/perl</li>
>  <li>dev-perl/TermReadKey</li>
>  <li>perl-core/Digest-MD5</li>
>  <li>dev-perl/IO-Socket-SSL</li>
>  <li>perl-core/MIME-Base64</li>
></ul>
>
><p>
>YoSucker is ~masked. Look in the file <path>/etc/make.conf</path> if the 
>variable <path>ACCEPT_KEYWORDS</path> contains <path>~</path> then please skip 
>to the next section. If it does not then we need to add it to your 
>package.keywords. Open the file <path>/etc/portage/package.keywords</path> and 
>add the following line:
></p>
>
><pre caption="keyword">
>net-mail/yosucker ~x86
><comment>(change ~x86 to reflect your architecture)</comment>
></pre>
>
>
><p>All needed packages will be merged as a dependency automatically. Install 
>YoSucker with the following command:
></p>
>
><pre caption="emerge">
>emerge yosucker
></pre>
>
></body>
></section>
>
><section>
><title>Configuration</title>
><body>
>
><p>
>YoSucker does not automatically create a default config file in your 
><path>~/</path> directory. Let's start by creating this file now. From a
> command line, logged in as the relevant user execute the following commands:
></p>
>
><pre caption="createconfig">
>mkdir ~/.yosucker
>touch ~/.yosucker/myyahoonick@yahoo.conf
><comment>(substitute the actual yahoo nick for myyahoonick)
></comment>
>nano -w ~/.yosucker/myemail\@myisp.conf
><comment>(Use whatever editor you prefer)</comment>
></pre>
>
><warn>
>Please remember to strip the (comment) tags from your .conf file.
></warn>
>
><p>
>Copy and paste the following code AS IS into your .conf file. Do not change this
> line. Even if you access Yahoo Mail through a <path>mail.yahoo.it</path> or 
>other language URL.
></p>
>
><pre caption="connect">
>&lt;Connect Info&gt;
>HOST=mail.yahoo.com
>&lt;/Connect&gt;
></pre>
>
><p>
>YoSucker encrypts your Yahoo password for storage. Use the included utility, 
><path>EncPasswd</path> to generate your encrypted password. Write it down for 
>use in the following section.
></p>
>
><pre caption="EncPasswd">
>EncPasswd
></pre>
>
><p>
>Copy and paste the following code into your .conf file. Read the (comments) and 
>make any required changes.
></p>
>
><pre caption="details">
>&lt;Login Details&gt;
>USERNAME=your_yahoo_id
>
>PASSWD=01010101010101010101010101010101
><comment>(Insert the output from the EncPasswd utility)</comment>
>
>SSL=1
><comment>(secure connection to login? 1 = Yes: 0 = No)</comment>
>
>FORCE4=0
><comment>(Some accounts, rocketmail.com for example, have a 4 step login process
>instead of the default 3 step process. Change to FORCE4=1 if YoSucker fails the 
>login procedure)</comment>
>
>RESPAWN=0
><comment>(Restore previous session. 1 = Yes; 0 = new login)</comment>
>&lt;/Login&gt;
>
>&lt;Fetch Mail&gt;
>BOX=Inbox,Sent,Draft
><comment>(comma seperated list of folders to fetch mail from. can include:
>Inbox, Sent, Trash, Draft, Bulk or any of your YM folders)
></comment>
>
>DIGEST=Bulk
><comment>(Any folder listed under DIGEST will have only it's header info 
>downloaded. Use a comma sperated list)</comment>
>
>PIPE=0
><comment>(0 = write to a file like /var/mail/USER; 1 = PIPE output to an 
>external program like procmail)</comment>
>
>OUTFILE=/var/mail/your_linux_user_name
><comment>(change to "procmail" for procmail support and PIPE=1 above)</comment>
>
>OUTFILE=cat > ~/.Maildir/new/`date +%s`.$$.yahoo
><comment>(For a maildir formatted file use this OUTPUT=)</comment>
>
>UNCHANGED=0
><comment>(restore read/unread status? 0 = No; 1 = After fetching; 2 = Immediate.
> Immediate will slow down fetching)</comment>
>
>LEAVE=1
><comment>(Leave mail on server? 0 = No; 1 = Yes. No will move all fetched mail 
>to the Trash)</comment>
>
>TRASH=0
><comment>(Empty Trash on Exit? 1 = Yes; 0 = No)</comment>
>
>BULK=0
><comment>(Empty Bulk Folder on Exit? 1 = Yes; 0 = No)</comment>
>
>QUOTA=80
><comment>(Warn me when my mailbox space reaches this percent full)</comment>
>
>LIMIT=25
><comment>(How many mails to fetch, 0 for ALL)</comment>
>
>SNEAKYSLEEP=1
><comment>(Yahoo will disable your account if you click to many links in a row in
> rapid succession. This option is how many seconds to wait betwen each click)
></comment>
>
>NOFROM=0
><comment>Remove the "From " beginning of message delimiter. Needed for some 
>mail processing apps</comment>
>&lt;/Fetch&gt;
></pre>
>
><p>
>YoSucker encrypts your Proxy password for storage. Use the included utility, 
><path>EncProxyPasswd</path> to generate your encrypted password. Write it down for 
>use in the following section.
></p>
>
><pre caption="EncPasswd">
>EncProxyPasswd
></pre>
>
><p>
>Continure to cut and paste the followoing code into your .conf file and follow 
>the (comments) to change the settings. If you do not use a Proxy you may leave 
>the Proxy settings out of your template. the Other section is also optional. The
> default DEBUG level is normal and is the recommended setting. Change to 2 if 
>experience problems to try and isolate the problem.
></p>
>
><pre caption="proxy">
>&lt;Proxy Settings&gt;
><comment>(Uncomment the following Proxy lines if you use a proxy. Otherwise 
>leave the #)</comment>
>
># PROXY=proxy.domain.com
># PROXY_PORT=8080
># PROXY_USER=your_proxy_username
>
># PROXY_PASS=XXXXXXXXX
><comment>(Use the included EncProxyPasswd utility to encrpyt the password)
></comment>
>
>&lt;/Proxy&gt;
>
>&lt;Other&gt;
>
>DEBUG=1
><comment>(quiet = 0, normal = 1, verbose = 2)</comment>
># Choose an action (i.e. a command to execute when new mail arrives
># ON_NEWMAIL="command attributes"
><comment>(External command to execute when new mail arrives. i.e. 
>/usr/bin/mpg123 ~/sounds/newmail.wav</comment>
>
>&lt;/Other&gt;
>
></pre>
>
></body>
></section>
>
><section>
><title>Header Translation</title>
><body>
>
><p>
>Just as YoSucker does not create a default .conf for you it also does not copy 
> header-translation to your ~/.yosucker directory that is necessary for YoSucker
> to work. Finding a permanent fix for this issue is beyond the scope of this 
>Guide. To get around this bug simply copy this file to your ~./.yosucker 
>directory like this:
></p>
>
><pre caption="header-translation">
>cp /usr/share/doc/yosucker-71/conf/header-translation ~/.yosucker/
></pre>
>
></body>
></section>
><section>
><title>Multiple accounts</title>
><body>
>
><p>
>To configure YoSucker to fetch multiple Yahoo Mail accounts simply make a copy 
>of the .conf file you just created and put it in your <path>~/.yosucker/</path> 
>directory. Each user can have their own <path>~/.yosucker/</path> .conf files 
>and can run <path>YoSucker</path> from the command line at any time.
></p>
>
><p>
>You may create a cron job to run YoSucker as a specific user at designated times
> or simply run <path>YoSucker</path> from the command line.
></p>
>
><p>
>If you get the error: <path>Another YoSucker is already running</path> but an 
>instance is not listed when you run the command:
></p>
>
><pre caption="ps -A">
>ps -A
></pre>
>
><p>
>Delete the .yosucker-lock file from your ~/ or ~./yosucker directory.
></p>
>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 24325: 60565 | 60566