index.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html>
   3   <head>
   4     <meta http-equiv="content-type" content="text/html; charset=utf-8">
   5     <title>Stand - A Very Simple POP3 Client</title>
   6     <link rel="stylesheet" type="text/css" href="../../random/style.css" title="mainstyle">
   7   </head>
   8
   9   <body>
  10
  11     <div class="photo-floating-right">
  12       <a href="http://www.flickr.com/photos/liz/7603729/">
  13         <img src="http://farm1.static.flickr.com/5/7603729_b257eaf8ba_t_d.jpg"
  14         alt="An excellent music stand photo taken by Liz Lawley" title="A
  15         excellent stand found on Flickr. (Photo taken by Liz Lawley.)">
  16       </a>
  17     </div>
  18
  19
  20 <h2><a name="stand">Stand - A Very Simple POP3 Client</a></h2>
  21
  22 <h3><a
  23 href="http://repo.or.cz/w/stand.git?a=blob_plain;f=stand;hb=version-0.96">Download
  24 version 0.96</a></h3>
  25
  26 <p>
  27 This is a small Ruby script for fetching mail from POP3 servers
  28 and delivering them to some LDA (Local Delivery Agent, typically
  29 <a href="http://www.procmail.org/">procmail</a>,
  30 although <a href="http://rrt.sc3d.org/">Reuben</a>
  31 recommends <a href="http://www.courier-mta.org/maildrop/">maildrop</a>).
  32 It does APOP authentication, SSL/TLS-wrapped POP3 and UIDL
  33 caching.</p>
  34
  35 <p>
  36 If you're using Debian, it depends on the following packages:
  37 </p>
  38 <ul>
  39 <li>ruby1.9.1</li>
  40 <li>libruby1.9.1</li>
  41 <li>libopenssl-ruby1.9.1</li>
  42 <li>libsqlite3-ruby1.9.1</li>
  43 </ul>
  44
  45 <p>I used nothing but the original script for dealing with my
  46 email for some years, but this is a brand new version based
  47 largely on the work of <a href="http://rrt.sc3d.org">Reuben
  48 Thomas</a>, who kindly took an interest in it.  As as result the
  49 code is now less than a third of its original size.
  50 </p>
  51
  52 <p>By default, stand deletes each message once it has been
  53 successfully delivered to the LDA so use a reliable LDA (such as
  54 procmail or maildrop) or you could easily lose mail.</p>
  55
  56 <p>
  57 stand uses a YAML configuration file called
  58 <tt>~/.stand.yaml</tt> that looks like this:
  59 </p>
  60
  61 <pre>
  62 # Comments start with `#'; leave a blank line between each
  63 # account's details.  The Host, User and Pass lines are
  64 # required.  Command defaults to "procmail -f-".
  65
  66 # For testing tpop3d:
  67
  68 -
  69   Host: localhost
  70   User: a@b.c
  71   Pass: not-my-password
  72   Command: procmail -f-
  73   APOP: yes
  74
  75 -
  76   Host: secure.mythic-beasts.com
  77   SSL: yes
  78   User: mark
  79   Pass: not-my-password-either
  80   Command: procmail -f-
  81
  82 -
  83   Host: pop.clara.net
  84   User: mark.longair
  85   Pass: something-else
  86   Command: procmail -f-
  87 </pre>
  88
  89 <p>
  90 The usage message (and the script itself) should tell you
  91 anything else you need to know.
  92 </p>
  93
  94 <p>Please bear in mind that it's quite possible that there may
  95 be bugs in these scripts that will cause you to lose mail; use
  96 this at your own risk.  You can download
  97 the <a href="http://repo.or.cz/w/stand.git?a=blob_plain;f=stand;hb=version-0.96">
  98 most recent version (currently 0.96) here</a> or from the link at
  99 the top of the page.  stand is released under the <a href="COPYING">GNU General
 100 Public License version 3.</a>
 101 </p>
 102
 103 <h4>Version Control</h4>
 104
 105 <p>The source code for stand is now maintained in
 106 a <a href="http://repo.or.cz/w/stand.git">git repository at
 107 repo.or.cz</a>.</p>
 108
 109 <div class="footer">
 110 <hr>
 111 <p>
 112 Mark Longair - <a
 113 href="mailto:mark-software@mythic-beasts.com">bugs or
 114 suggestions?</a> (<a
 115 href="http://validator.w3.org/check/referer">validate HTML</a> |
 116 <a
 117 href="http://jigsaw.w3.org/css-validator/check/referer">validate
 118 CSS</a>)
 119   </p>
 120   </div>
 121
 122 </body>
 123
 124 </html>