<html>
<head>
<title>fk_html html mail converter </title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body bgcolor="#13132B" text="DFF8FF">
<b><font size=+1> USING FK_HTML:</font></b>
<p>Initial fk_html output:
<br>
<p><font color="006699">~$ ./fk_html.pl </font>
<p><font color="#006699">Use: <br>
fk_htmll.pl [-v]</font>
<blockquote>
<p><font color="#006699">edit ~/.fk_html.conf</font></p>
</blockquote>
<p><font color="#006699"> OPTIONS: <br>
-v => show client and server
output on STDOUT <br>
</font></p>
<p><font color="#006699">~$ </font>
<p>All fk_html settings are stored in ~/.fk_html.conf
<p>Use -v option for debugging purposes (and bug report plzz:)
<p>
<p>Settings: (.fk_html.conf file)
<blockquote>
<p>An example of config file:</p>
<blockquote>
<p><font color="#009900"> fk_html config file (~/.fk_html.conf)</font></p>
<p><font color="009900">Section 1:Accounts<br>
<account></font></p>
<p><font color="009900">local port<br>
7070</font></p>
<p><font color="009900"> pop3 server adderss<br>
papuasia.org</font></p>
<p><font color="009900"> pop3 port</font></p>
<p><font color="009900">110</font></p>
<p><font color="#009900">use SSL? (SSL_YES or SSL_NO)</font></p>
<p><font color="009900">SSL_NO</font></p>
<p><font color="#009900"><br>
#Apply filters? (FILT_YES or FILT_NO)<br>
#if FILT_YES, provide:<br>
# MODE:<br>
# B -> block all mails from <blocklist><br>
A -> allow mails only from <allowlist></font></p>
<p><font color="009900"># POLICY:<br>
# I -> ignore all filtered mails<br>
H -> download headers only</font></p>
<p><font color="009900">#for example: FILT_YES B H<br>
#it will download only headers of mails from <blocklist></font></p>
<p><font color="#009900">FILT_NO</font></p> <p><font color="#009900">Apply html conversion?? (HCONV_YES or HCONV_NO)</font></p> <p><font color="009900">HCONV_YES</font></p> <p><font color="#009900">#Remove only Scripts from HTML (RM_SCRIPT_YES or
RM_SCRIPTS_NO)<br>
# if HCONV_YES it is always YES<br>
RM_SCRIPTS_YES<br>
</account></font></p>
<p></p>
<p><font color="#009900"><account><br>
7071</font></p>
<p><font color="#009900">popmail.myserver.it</font></p>
<p><font color="#009900">995</font></p>
<p><font color="#009900">SSL_YES</font></p>
<p><font color="#009900">FILT_YES B H</font></p>
<p><font color="#009900">HCONV_NO</font></p>
<p><font color="#009900">RM_SCRIPTS_YES<br>
</account></font></p>
<p><font color="#009900"><EndSection></font></p>
<p><font color="#009900">Section 2:Global Filtering</font></p>
<p><font color="009900"><blocklist><br>
Newsletter@iol.it<br>
</blocklist></font></p>
<p><font color="#009900"><allowlist><br>
</allowlist></font></p>
<p><font color="#009900">END OF CONFIG FILE </font><br>
</p>
</blockquote>
<p> </p>
</blockquote>
<p><b><font size="+1" color="0000FF">Section 1: Accounts</font></b>
<blockquote>
<p>Multiple accounts can be stored in <account> ... </account> blocks
with the following sintax:</p>
<blockquote>
<p><b>1st line</b>: local port for this account, where fk_html will wait for
your connection </p>
<blockquote>
<p><b>NOTE</b>:<br>
every <i>account block</i> must have a UNIQUE local port number <br>
<p>if you have 2 or more accounts on the same pop3 server only one <i>account
block</i> in needed</p>
<blockquote>
<blockquote>
<p> </p>
</blockquote>
</blockquote>
</blockquote>
<p><b>2nd line</b>: your pop3 server address</p>
<p><b>3rd line</b>: your pop3 server port (usually 110 if no SSL)</p>
<p><b>4th line</b>: Use SSL for this server?? If yes write SSL_YES else write
SSL_NO</p>
<p><b>5th line</b>: Apply filters? (FILT_YES or FILT_NO)</p>
<blockquote>
<p><b>NOTE:</b></p>
<p>If FILT_YES you must provide:</p>
<blockquote>
<p> MODE:<br>
B -> block all mails from <i>blocklist</i><br>
A -> allow mails only from <i>allowlist</i></p>
<p>POLICY:<br>
I -> ignore all filtered mails<br>
H -> download headers only</p>
<p>for example: FILT_YES B H<br>
it will download only headers of mails from <i>blocklist</i></p>
</blockquote>
<p> </p>
</blockquote>
<p><b>6th line</b>: Apply html conversion?? (HCONV_YES or HCONV_NO)</p>
<p><b>7th line</b>: Remove only Scripts from HTML?? (RM_SCRIPT_YES or RM_SCRIPTS_NO)</p>
<blockquote>
<p><b>NOTE:</b><br>
if HCONV_YES it is always used</p>
</blockquote>
<p> </p>
<p><b><i><EndSection></i></b><br>
</p>
</blockquote>
</blockquote>
<p><font color="#660000"><b><font color="#0066CC">NOTE: any section must be closed
with <i><EndSection></i> tag except the last section</font></b></font>
<p>
<p><b><font size="+1" color="#0000FF">Section 1: Global Filtering</font></b>
<p>In this section there are 2 blocks: <blocklist> .... </blocklist>
and <allowlist> .... </allowlist>
<p>As their names suggest the first block contanis the list of addresses that
will be blocked, and the second one contanis the list of allowed addresses
<blockquote>
<blockquote>
<p><b>NOTE:</b><br>
<p>blocklist and allowlist could contain also part of addresses For example
an occourrence of " <i>poplix</i>" in blocklist wil tell to fk_html
to block all emails that contanis the string "poplix" in <i>FROM
</i>field of headers (i.e. poplix@papuasia.org, necci@poplixnerd.com, ecc.....)</p>
</blockquote>
</blockquote>
<p>this section is used by the 5th line of any <i>account block</i>
<p>
<p><b><i><font color="#0000FF">END OF CONFIG FILE</font></i></b>
<p>
<p>
<p><b><font color="#9999CC" size="+1">Example: </font></b>
<p><b>You have the following accounts: </b>
<blockquote>
<p>necci@server.com and your pop3 is pop3.server.com </p>
<p>arabico@server.com and your pop3 is pop3.server.com </p>
<p>dim@dirtyim.org and your pop3 is dirtyim.org with SSL on port 995</p>
</blockquote>
<p><b>You hate:</b>
<blockquote>
<p>billgates@linux.org</p>
<p>franco@paranco.com</p>
<p>mariorossi@lido.it</p>
</blockquote>
<p><b>You love:</b>
<blockquote>
<p>poplix@papuasia.org</p>
<p>norlien@papuasia.org</p>
<p>heretto@sanzio.org</p>
<p>and all users from trnepal.net</p>
<p> </p>
</blockquote>
<p>dim@dirtyim.org is your main mailbox and your two accounts on server.com are
used for general purposes</p>
<p>To download mail from dirtyim.org you use an advanced mail client (but without
SSL support ) that render html mails.You like html mails (why??), but you know
that some malicious script can be executed by html processor.</p>
<p>To check mail from server.org you use with a low-level mail client that cannot
handle html</p>
<p> </p>
<p>Your config file will be:</p>
<blockquote>
<p><font color="#00CC00"><account><br>
</font><font color="#00CC00">5431<br>
</font><font color="#00CC00">dirtyim.org<br>
</font><font color="#00CC00">995<br>
</font><font color="#00CC00">SSL_YES<br>
</font><font color="#00CC00">you will recive mails only from people you love,
all others mails will be ignored <br>
</font><font color="00CC00">FILT_YES A I<br>
</font><font color="#00CC00">HCONV_NO<br>
</font><font color="#00CC00">RM_SCRIPTS_YES<br>
</font><font color="#00CC00"></account></font></p>
<p><font color="#00CC00"><account><br>
5432<br>
server.com<br>
110<br>
SSL_NO<br>
you will recive mails from anyone except from your blocklist, but fk_html
will download headers of filtered mails<br>
FILT_YES B H<br>
</font><font color="00CC00">HCONV_YES<br>
</font><font color="#00CC00">RM_SCRIPTS_YES<br>
</font><font color="#00CC00"></account></font></p>
<p><font color="#00CC00"><EndSection></font></p>
<p><font color="#00CC00"><blocklist><br>
billgates@linux.org<br>
franco@paranco.com<br>
mariorossi@lido.it</font><br>
<font color="#00CC00"></blocklist></font></p>
<p><font color="#00CC00"><allowlist><br>
poplix@papuasia.org<br>
norlien@papuasia.org<br>
heretto@sanzio.org<br>
all users of trnepal.net<br>
@trnepal.net</font><br>
<font color="00CC00"></allowlist></font></p>
<p><font color="#00CC00">END CONFIG</font></p>
</blockquote>
<p>
<p><br>
<p>Edit your account settings in your advanced mail client:
<blockquote>
<p><font color="00CC00">user: dim<br>
pass: ******* <br>
pop3: 127.0.0.1<br>
port: 5431</font></p>
</blockquote>
<p>And in the other clinet</p>
<blockquote>
<p><font color="#00CC00">user: necci<br>
pass: *******<br>
pop3:127.0.0.1<br>
port: 5432</font></p>
<p><font color="#00CC00">user: arabico<br>
pass: *********<br>
pop3:127.0.0.1<br>
port: 5432</font></p>
</blockquote>
<p><br>
<p><b>Run fk_html</b>
<p><font color="#006699">~$ ./fk_html </font>
<p><font color="#006699">fk_html started with 2 accounts<br>
~$ </font>
<p><font color="#009900"><b><font color="#33FFCC">Check your mail! </font></b></font>
<p>
<p>fk_html has been written by poplix and is under GPL license
<p>Comments and bug reports are welcome (<a href="mailto:poplix@papuasia.org">poplix@papuasia.org</a>)
<p>
</body>
</html>
