                                  HTML2POP3
                              -----------------
                       By Matteo Baccan (www.baccan.it)
                    --------------------------------------

Quando ci si trova dietro ad un proxy aziendale, o quando ci si trova
nella condizione in cui le porte POP3, SMTP o NNTP sono state chiuse
all'interno di un'azienda, ci si puo' trovare nell'impossibilita' di
scaricare e inviare della posta tramite Outlook o tramite un qualsiasi
client di posta che utilizza il protocollo POP3, SMTP e NNTP.

Per questa ragione, ho scritto, sulla falsariga di altri programmi
simili per Hotmail o Yahoo, un server POP3, SMTP e NNTP, in grado di
discriminare una richiesta entrante e fornire un servizio POP3, SMTP e
NNTP, interfacciando le interfacce HTTP dei server di posta elettronica
e dei server HTTP in grado di fare da proxy SMTP e NNTP.

In principio questo programma era nato per libero.it, ma, col passare
del tempo, sono nate una serie di altre esigenze, che mi hanno portato
ad una sua evoluzione e a considerare la possibilita' di gestire a
plugin il server POP3, SMTP e NNTP, in modo da poterlo estendere a tutta
un altra serie di portali.

Al momento e' infatti possibile interfacciarsi a libero.it, inwind.it,
blu.it, iol.it e infinito.it etc etc, ma molti altri plugin sono in
preparazione.

Inoltre, per il fatto che, molte volte ci si trova dietro ad un server
proxy, ho provveduto anche a gestire questo tipo di connessione.

Dato che non si sa mai, ho provveduto a riempire il programma di flag
in modo che la posta non vada mai perduta e sia comunque possibile
gestire  dei backup o usare il programma in modalita' sicura.

Per questa ragione, ho abilitato un flag per disabilitare, in modo
globale il delete dei messaggi, in modo da evitare eventuali problemi
di cancellazioni indesiderate. Oltre ad un altro flag per poter  avere
in attach la pagina html che traduco in messaggio POP3, nel caso  di
mail emulate.

Se pero' non vi fidate proprio, ricordatevi che programmi come il  mio
lavorano in emulazione di una casella POP3 che non esiste, vi consiglio
di gestire la posta, mantenendo una copia dei messaggi sul server.
In alternativa potere abilitare il flag:

"Conserva una copia dei messaggi sul server"

in modo che il client di posta non cancelli i dati dal server e ne
mantenga una copia.

HTML2POP3 e' stato scritto in Java 1.4.2, anche se penso che sia
utilizzabile anche su versioni meno recenti di JDK, ma non avendo fatto
dei test non ne ho una certezza matematica.

Usate questo programma con Linux, Windows, AIX, Sun Solaris o tutti gli
ambienti che riterrete opportuni

Inoltre, in caso di vostre estensioni, sarei felice di poterle ricevere
per poterle integrare nelle nuove release di HTML2POP3, sapendo che
comunque sara' sempre dato tutto in sorgente.


Caselle di posta attualmente supportate
=======================================

Aliceposta.it Blu.it Cicciociccio.com Clarence.com Email.it
Fastwebnet.it Freemail.it Freeweb.org Hotmail.com IOL.it InWind.it
Infinito.it genie.it Libero.it Mp4.it Mybox.it Superdada.com Supereva.it
supersonic.it dadacasa.com concento.it clarence.com Tim.it Tin.it
Tiscali.it tele2.it e indirettamente qualsiasi server pop3: a-ice.aero
abes.it aliceposta.it allmediasolution.com altevie.com arpa.sicilia.it
aruba.it asp.it bangladesh.net bccsanteramo.it bmsitalia.com bonbon.net
bsc.it cleffe.it coldiretti.it comm2000.it deejaymail.it
drinkpinkonline.com ecom.it ecorete.it edimedia.com ekar.it email.it
excite.it fastwebnet.it finsa.it freepass.it gmx.net gruppoacsi.com
hotmail.com ilgiornaledicinisi.it infinito.it infomedia.it
interfree.it istruzione.it itstaff.it jumpy.it katamail.com lifegate.it
lifegate.it lillinet.org lokisrl.com net2b.pt netcomsolution.it
next.dom next.it oksatcom.it poste.it postino.it preito.com quipo.it
ragionieri.com ribesinformatica.it rocchelli.net sicilyonline.it
simail.it squalex.com techedge.it tecredo.com templarios.com tim.it
tin.it tiscali.it topconsulting.it toughguy.net trim.it uniroma2.it
vodafone.it wappi.com wind.it wisyprod.com yahoo.it studioluraghi.it
et cetera et cetera

Versioni possibili
==================

HTML2POP3 e' disponibile in due versioni completamente diverse.

La prima dal nome html2pop3???.zip dove al posto di ??? e' presente un
numero di  versione, come protrebbe essere html2pop3120.zip. Questa
versione e' compilata con il JDK SUN ed e' ideale per qualsiasi sistema
operativo, dispone di tutte le funzionalita'  possibili, ha una GUI in
grado di configurarne le opzioni e un codice ottimizzato per quanto
riguarda le connessioni.

La seconda ha il nome identico, con l'aggiunta di suffisso win32:
html2pop3???win32.zip, come potrebbe essere html2pop3120win32.zip Questa
seconda versione e' compilata con il JDK Microsoft, e non quello SUN,
come la  versione portabile, per tale ragione dispone di un EXE. Questa
versione funziona solo in ambienti Windows dotati di JVM Microsoft. Dato
che, fino a prima di Windows XP, qualsiasi Windows aveva una JVM
Microsoft, basta scaricare il programma ed utilizzarlo.  Con XP e'
invece necessario scaricare la JVM Microsoft
(http://www.baccan.it/opensource/msjavx86.exe) prima di utilizzarlo per
evitare l'errore di "interfaccia non registrata"

In base alla versione che avete scaricato occorre quindi seguire un
tutorial diverso


Istruzioni per l'installazione della versione portabile
=======================================================

  La versione portabile, essendo pensata per tutte le piattaforme
  non possiede un file di installazione, ma e' composta da un semplice
  zip con dentro tutto quello che serve per funzionare.

  Inoltre i settaggi che sono stati messi di default dovrebbero andare bene
  per tutte le piattaforme esistenti.

  Una volta installato si puo' cosi passare direttamente a configurare
  il programma di posta.

  Da notare che HTML2POP3 e' pensato come se fosse un server, puo'
  quindi supportare tranquillamente il carico parallelo di piu' macchine
  presenti in una rete aziendale.

  ----------------
  Ambiente Windows
  ----------------
  1) scaricate l'ultima versione di HTML2POP3 (html2pop3???.zip) dal sito
  http://www.baccan.it

  2) decomprimete il tutto in una nuova cartella (es c:\programmi\html2pop3)

  3) eseguite il file html2pop3.bat

  4) Se a schermo appare la schermata del programma riducetelo a icona (senza
  chiuderlo) e avete terminato
  La schermata che dovrebbe apparirvi e' simile a questa

  http://www.baccan.it/opensource/html2pop3.jpg

  Altrimenti vi verra' dato un errore tipo "file javaw.exe mancante".

  Scaricate ed installatevi le Java Runtime Environment (JRE) dal seguente
  link: http://java.sun.com/webapps/download/AutoDL?BundleId=8939, oppure
  direttamente dal sito sun http://java.sun.com

  Le istruzioni per installare le JRE fate clic sul link qui sotto:
  http://www.java.com/it/download/help/win_manual.jsp

  ------------
  Ambiente MAC
  ------------
  Questo esempio e' scritto su Panther. Si rigrazia Davide per il gentile
  supporto

  1) scaricate l'ultima versione di HTML2POP3 (html2pop3???.zip) dal sito
  http://www.baccan.it

  2) scompattatelo in una directory della vostra *home* (es. ~/Applications)

  3) Aprite il terminale e spostatevi all'interno della cartella che avete
  appena scompattato.

  4) nel terminale scrivete "sudo java -cp html2pop3.jar htmlgui" (senza
  virgolette, ovviamente...)

  5) Aspettate e si presentera' l'interfaccia del programma

  6) Sostituite la stringa "locahost" con 127.0.0.1

  7) Premete il tastone "restart"

  8) A questo punto potete continuare seguendo le istruzioni che sono
  allegate al programma, l'unica cosa che cambia e' dove Baccan dice di
  usare locahost mettete 127.0.0.1 .

  D'ora in poi vi bastera' avviare il programma con il comando dal
  terminale che trovate al punto 4.

  Per automatizzare il tutto io ho fatto un piccolo applescript e l'ho
  salvato come applicazione e messo in avvio al login

  Vi posto LA riga dello script, a questo punto passo la mano a qualcuno
  piu' esperto di applescript (io lo conosco a malapena) in grado di
  migliorarlo

  Ecco la riga:

  do shell script "sudo java -cp <<path del .jar>>/html2pop3.jar htmlgui"
  password "<<la vostra password>>" with administrator privileges

  -------------
  Ambiente OS/2
  -------------
  1) scaricate l'ultima versione di HTML2POP3 (html2pop3???.zip) dal sito
  http://www.baccan.it

  2) decomprimete il tutto in una nuova cartella (es c:\programmi\html2pop3)

  3) Scaricate java runtime 1.4.2

  http://download.innotek.de/javaos2/142_01/install.exe

  4) trasformare il .bat in .cmd

  rem html2pop3.cmd
  @echo off
  :: server con la GUI
  set HLIB=html2pop3.jar;httpclient.jar;httpmail.jar;xercesImpl.jar;xmlParserAPIs.jar
  start D:\java142\bin\javaw.exe -cp %HLIB% htmlgui

  dove d:\java142\etc etc e' il percorso dove avere installato java

  5) eseguite il file html2pop3.cmd

  A questo punto tutto dovrebbe andare

  --------------
  Ambiente Linux
  --------------
  1) scaricate l'ultima versione di HTML2POP3 (html2pop3???.zip) dal sito
  http://www.baccan.it

  2) decomprimete il tutto in una nuova cartella

  3) Scaricate java runtime 1.4.2

  4) Modificate il file html2pop3.sh, mettendo il percorso dove avete
  installato html2pop3 e java

  5) Eseguite tramite sh lo script di partenza

  sh html2pop3.sh start


  altrenativamente potete fare dare i permessi di esecuzione allo script con

  chmod ug+x html2pop3.sh

  metterlo nel PATH (`echo $PATH` per vedere qual'e` il PATH) e eseguirlo
  semplicemente scrivendo

  html2pop3.sh start


Istuzioni per l'installazione della versione Win32 - solo Windows
=================================================================

  1) scaricate l'ultima versione di HTML2POP3 (html2pop3???win32.zip) dal sito
  http://www.baccan.it

  2) decomprimete il tutto in una nuova cartella (es c:\programmi\html2pop3win32)

  3) eseguite l'exe html2pop3.exe

  4) Se sulla barra delle applicazioni appare un'icona con una I, allora il
  programma e' installato correttamente e avete terminato
  Altrimenti vi verra' dato un errore tipo "interfaccia non registrata"

  Scaricate ed installatevi la Microsoft Java Virtual Machine dal seguente link:
  La VM Microsoft e' scaricabile da questa pagina

  http://www.baccan.it/opensource/msjavx86.exe

  una volta installata dovrebbe andare tutto a posto


Controlli comuni
================

Per varie ragioni, il programma potrebbe non riuscire a partire correttemente.
Per questo motivo si consiglia sempre di controllare il file html2pop3.log
e guardare che non ci siano problemi. In caso di problemi e' normalmente indicata
la soluzione o comunque e' indicata nel file readme.txt


Utilizzo della versione POP3
============================

1) Aprite il vostro Outlook Express, o il vostro programma di posta
preferito

2) In Strumenti->Account->(nome account)->Proprieta'->Server->Posta in
entrata (POP3) inserite "localhost" (senza le virgolette), mentre in
Posta in uscita lasciate il server SMTP del vostro provider.

3) Se, per qualsiasi ragione, avete dovuto cambiare la porta di
funzionamento  di HTML2POP3, passando dalla 110 a qualcos'altro, ad
esempio 111, ricodatevi  di aggiornare questa parametro sotto
Outlook->strumenti->account->(nome account)->Impostazioni
avanzate->Posta in arrivo

4) HTML2POP3 utilizza il nome dell'account di posta, per capire quale
webmail deve essere utilizzata. Per questo motivo e' importante mettere
sempre l'email completo come nome dell'account che si intende
controllare

Ad esemipio: se avere la posta su libero.it, potere mettere, come
account

?????????@libero.it

dove al posto di ???????? indicherete il vostro email, oppure potete
forzare l'utilizzo di una certa casella di posta, indicando il nome
del plugin da utilizzare, prima dell'account di posta:

libero.it;????????@libero.it

in questo modo indicate che, qualsiasi cosa sia scritta, occorre
utilizzare il plugin libero.it

Alla luce di questo, sono impostazioni valide

pippo@libero.it
libero.it;pippo@libero.it

ma non

pippo

in questo caso non c'e' il modo di sapere quale gestore di posta
usare e HTML2POP3 si limita ad usare il default che e' libero.it

A questo punto siete in grado di utilizzare liberamente la posta
esattamente come facevate prima.

NOTA: NON chiudete mai HTML2POP3, altrimenti il vostro programma di
posta non puo' scaricare la posta

Per avere un esempio di come configurare questi flag guardate
il file html2pop3config1.jpg e html2pop3config2.jpg


Utilizzo della versione SMTP
============================
Dalla versione 2.00 e' possibile utilizzare html2pop3 come server SMTP,
basta configurare il proprio client nel seguente modo

Server SMTP : localhost, o l'indirizzo che avete configurato
Porta  SMTP : 25, o la porta che avete configurato

Facendo solo questi due settaggi, viene utilizzata una tecnica di
tunneling HTTP. La posta viene incapsulata in una chiamata HTTP e
inviata al server baccan.it tramite un POST. Da baccan.it viene poi
chiamato il server SMTP interno per l'invio effettivo della posta.

Se pero' non si vuole usare il server SMTP di baccan.it, ma si vuole
solo usare baccan.it  per il tunneling della posta, e' possibile
indicare a quale altro server SMTP inviare il messaggio.

Per fare questo occorre aggiungere l'autentificazione sul server SMTP e
usare la seguente tecnica

Login   : smtp;la vostra login;server smtp[;porta smtp[;server delle pagine php]]
Password: la vostra password

in questo modo, l'invio avverra' verso il server "server smtp" sulla
porta "porta smtp" e le pagine contattate in modalita' POST saranno su
"server delle pagine php"
Tanto per avere un esempio. Per far fare l'invio con virgilio, possiamo
scrivere

smtp;TUA_EMAIL@virgilio.it;smtp.virgilio.it

oppure

smtp;TUA_EMAIL@email.it;smtp.email.it

la mail verra' inviata a baccan.it che la rimandera' a virgilio, in modo
del tutto trasparente.

Non ancora contenti e' possibile fare anche

smtp;TUA_EMAIL@virgilio.it;smtp.virgilio.it;25;http://TUO_SERVER/pagine_php

per fare in modo che, al posto di contattare baccan.it, venga contattato
il server web http://TUO_SERVER/pagine_php. Chiaramente al posto di "TUO_SERVER"
e di "pagine_php" occorre immettere un valore adeguato.
Per fare un esempio, io ho messo le pagine su www.baccan.it nella directory
pop3. Quindi un indirizzo valido e'

http://www.baccan.it/pop3

Per vedere come configurare l'invio SMTP guardate i file html2pop3smtp1.jpg
e html2pop3smtp2.jpg

ATTENZIONE: se non usate un vostro server per mettere le pagine PHP che
ho  reso disponibili con HTML2POP3, e usate baccan.it, vi arrivera' una
mail  giornaliera che vi avvisa dell'uso del servizio gratuito.  La mail
si puo' eliminare semplicemente mettendo le pagine su un vostro server che
esegue PHP e puntando quel server al posto di baccan.it, come indicato
qualche riga sopra.

NB: baccan.it non memorizza il vostro indirizzo di email per capire se
e' la prima mail che inviate nella giornata, ma il crypt della mail. In
questo modo  nessun dato sensibile e' registrato, dato che crypt non e'
reversibile e non  si puo' quindi tornare alla stringa che ha generato
quel crypt. Potete analizzare il codice guardando il file phpproxy.zip
allegato a HTML2POP3.

IMPORTANTE: se avete un server SMTP a disposizione, usatelo, al posto
di usare il tunnel su baccan.it, dato che, per problemi di SPAM, ho
dovuto mettere dei filtri su dimensione e numero di destinatari, quindi
risulta molto piu' veloce e sicuro un server SMTP al posto del tunnel
su baccan.it


Utilizzo della versione NNTP
============================
Dalla versione 2.10 e' possibile utilizzare html2pop3 come server NNTP,
basta configurare il proprio client nel seguente modo

Server NNTP : localhost, o l'indirizzo che avete configurato
Porta  NNTP : 119, o la porta che avete configurato

a questo punto HTML2POP3 permettera' di utilizzare i newsgroup nelle
situazioni in cui non si abbia a disposizione un server NNTP

Il meccanismo si basa sull'interfacciamento di Google e la trasformazione
delle pagine HTTP in messaggi NNTP validi.

Quando il client chiede l'elenco dei gruppi viene restituita la lista
presente in

nntp.cfg

Questo file e' modificabile a piacere.
Fatto questo, quando il client di posta chiede un nuovo gruppo

GROUP nome_del_gruppo

il programma accede a google sulla pagina riassuntiva di nome_del_gruppo
A quel punto prende tutti gli ID dei messaggi, e, dove presenti dei thread
segue il thread per prenderne i messaggi che lo compongono.

Una volta che ha la lista degli ID dei messaggi, procede al loro
download, utilizzando una cache posta nella directory

nntpcache\nome_del_gruppo

in questo modo, successive richieste dello stesso messaggio non lo scaricano
nuovamente. Questa opzione e' particolarmente utile in ambito di rete, dove
piu' persone utilizzano una sola istanza di HTML2POP3.

Una volta che ha i messaggi, li numera in modo progressivo, memorizzando
la numerazione in un file chiamato

nntpcache\nome_del_gruppo\id-cache.cache

in questo modo, successivi download utilizzeranno le id del file id-cache.cache
e non andranno a mischiare nuovi messaggi con vecchi messaggi, dato che
il protocollo NNTP si basa sulla numerazione del messaggi e non sul loro ID

Dato che il primo giro di download dei messaggi puo' essere lento, la
procedura migliore e' quella di aumentare il timeout da 1 a 5 minuti.
I successivi aggiornamenti dovrebbero essere piu' veloci, sfruttando il
sistema di cache.
In realta' ci potrebbero essere ulteriori ritardi, introdotti dal modo col
quale i clienti NNTP gestiscono l'interfacciamento del server NNTP.
Nelle prossime release aumentero' le performance del programma

ATTENZIONE: non e' stato implementato il POST su newsgroup, ma solo la lettura


Integrazione con altri programmi
================================

  -----------
  Spamhilator
  -----------
  Questo piccolo tutorial e' stato scritto per permettere a chi usa
  Spamhilator come filtro anti-spam e outlook express come client di posta
  elettronica,di utilizzare contemporamente  anche l'ottimo html2pop3..
  Per far convivere i due programmi occorre fare qualche piccola  modifica
  che vado a spiegare;

  1) Impostare Html2pop3 su:

  server: localhost
  porta: 111

  2) Spamhilator non deve essere toccato (rimane quindi sulla porta 110)

  3) In outlook express modificate come segue il vostro account email:
  cliccate su STRUMENTI>ACCOUNT>POSTA ELETTRONICA
  scegliete l'account da modificare e evidenziate SERVER

  a questo punto la situazione dovrebbe essere:

  posta in arrivo (pop3): localhost
  posta in uscita (SMTP): vostro_smtp_server

  nome account: localhost&TUA_EMAIL@libero.it&111
  esempio pratico: localhost&pippo@libero.it&111

  password: vostra_password

  e il gioco e' fatto!

  A questo punto html2pop3 passa la posta a spamhilator che la filtra e la
  restituisce a outlook express.
  Ovviamente il tutto e' leggermente piu' lento ma ovviamente il gioco
  vale la candela!
  Spero che questo piccolo tutorial possa essere di aiuto a chi come me
  usa questi 2 programmi.

  Giuseppe Galluzzo

  -------
  Spampal
  -------
  Come da oggetto sono riuscito a far andare in cascata quei programmi,
  ora a beneficio di chiunque altro avesse questo problema descrivo
  brevemente come ho fatto.

  1) ho impostato l'account di libero sulla porta 91

  2) ho impostato html2pop3 sulla porta 90

  3) nella schermata connections nelle opzioni di spampal ho fatto
  add port e l'ho impostata sulla 91 (tipologia ho lasciato pop3),
  serverName: localhost:90(richiamo a html2pop3).
  Cos facendo per tutte le connessioni che richiedono la porta 91
  spampal si connette con il localhost sulla 90

  4) html2web scarica e passa a spampal, spampal restituisce i messaggi
  a outlook. per tutte le altre funziona come ha sempre funzionato.

  NB: Ricordatevi di usare questa sintassi per lo username

      libero.it;TUA_EMAIL@libero.it@127.0.0.1

  Spero che questa mini-guida le sia utile e di non aver ripetuto
  qualcosa che e' gi stato detto. Credo che comunque sia possibile
  configurare questi 2 programmi con due altre porte, facendo
  attenzione pero' a non usare porte standard, e credo che
  funzioni anche per altre applicazioni anti-spam tipo spamAssassin per linux.

  Marcello Magaldi

  -----
  AVAST
  -----
  Per usare avast, occorre far partire html2pop3 sulla porta 111,
  modificando il file config.cfg e poi configurare l'utente in outlook nel
  seguente modo

  TUA_EMAIL@TUO_SERVER#localhost:111

  ad esempio

  pippo@libero.it#localhost:111

  nel tuo programma di posta, come indirizzo del server, mantieni: localhost
  e come porta: 110


  ---------------------
  Norton Antivirus 2002
  ---------------------
  In questo caso basta lasciare HTML2POP3 sulla porta 110. Norton intercetta
  la chiamata e controlla automaticamente.


  -------------------
  AVG Pro 7 Antivirus
  -------------------
  Occore modificare il programma di posta nel seguente modo

  Server POP3: localhost
  Porta  POP3: 5300

  Poi in AVG, entrate in "Proprieta' -> Servers -> Creare un server di posta POP3"
  In connection impostare Fixed host: 127.0.0.1:110 e local port 5300


Ricompilazione
--------------
Il programma e' gia compilato, per chi pero' volesse apportare
delle modifiche, puo' scaricare il file con i sorgenti e ricompilare il
tutto

Inoltre, per poter modificare la GUI occorre disporre di NetBeans IDE,
3.5 o 3.5.1, compreso in Java 1.4.2

Per la versione win32 occorre l'SDK Microsoft, ormai merce rara, provate
a scaricarlo da qui

http://gd.tuwien.ac.at/pc/bazar/sf-exe/w/webunitproj/SDKJava40.exe


Configurazioni non GUI
======================
Di seguito potete trovare tutta una serie di batch che vi possono
aiutare a fare dei test, senza utilizzare l'interfaccia grafica


Se volete provare il get delle mail di libero da riga comando potete provare questo batch

@echo off
:: test con parametri da riga comando
java -cp html2pop3.jar libero %1 %2>libero.htm


Se volete provare il get delle mail di infinito da riga comando potete provare questo batch

@echo off
java -cp html2pop3.jar infinito %1 %2>infinito.htm


Se volete attivare il server senza la gui potete provare questo comando

@echo off
:: server senza la gui
java -cp html2pop3.jar html2pop3


Se volete attivare il server senza la gui e senza nessun messaggio o icona a video
potete provare questo comando

@echo off
:: server hidden
set HLIB=html2pop3.jar;httpclient.jar;httpmail.jar;xercesImpl.jar;xmlParserAPIs.jar
start javaw.exe -cp %HLIB% html2pop3



Configurazioni client di posta
==============================
Di seguito trovare una serie di configurazioni che dovete adottare, nel
vostro clienti di posta (outlook, eudora etc), divise in base al provider
che avete intenzione di contattare


SUPPORTO COMPLETO
-----------------
Con questi plugin e' possibile attivare anche la cancellazione
in quanto il loro supporto e' completo


Per gestire la posta su libero.it

Login   : libero.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su inwind.it

Login   : inwind.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su blu.it

Login   : blu.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su iol.it

Login   : iol.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su infinito.it

Login   : infinito.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su genie.it

Login   : infinito.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su hotmail.com

Login   : hotmail.com;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato


Per gestire la posta su tin.it e virgilio.it

Login   : tin.it;TUA_EMAIL@tin.it
    oppure
Login   : tin.it;TUA_EMAIL@virgilio.it
    oppure
Login   : TUA_EMAIL@tin.it
    oppure
Login   : TUA_EMAIL@virgilio.it

Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato


Per gestire una qualsiasi risorsa RSS

Login   : rss;
    oppure
Login   : QUALSIASI_EMAIL@rss
    oppure
Login   : QUALSIASI_EMAIL@aggregator

Password: all
   oppure
Password: ALIAS_DEL_RSS_PRESENTE_IN_RSS.CFG
   oppure
Password: URL_RSS

Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Un esempio di possibile RSS e'

Login   : rss;
Password: jobcrawler.it
Server  : localhost
Porta   : 110

dove jobcrawler.it e' l'alias presente in rss.cfg



SUPPORTO COMPLETO - accesso tramite plugin POP3
-----------------------------------------------
L'uso dell'interfaccia generica POP3 presente in HTML2POP3 dalla
versione 1.24 in su, permette di usare virtualmente qualsiasi POP3
anche se posti dietro a un proxy HTTP, cosa che in ambito
aziendale e' molto frequente.

In questo caso e' comodo poter usare il plugin POP3, nel seguente
modo:

Login   : pop3;la vostra login;server pop3[;porta pop3[;server delle pagine php]]
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Anche in questo caso, come nel caso di SMTP, viene usata una tecnica di
tunneling HTTP. La richiesta di nuovi messaggi di posta viene
incapsulata in una chiamata HTTP verso baccan.it, che contatta
direttamente il server POP3 che contiene la posta e incapsula la
risposta in una risposta HTTP.

ATTENZIONE: se non usate un vostro server per mettere le pagine PHP che
ho  reso disponibili con HTML2POP3, e usate baccan.it, vi arrivera' una
mail  giornaliera che vi avvisa dell'uso del servizio gratuito.  La mail
si puo' eliminare semplicemente mettendo le pagine su un server che
esegue PHP e puntando quel server al posto di baccan.it, come indicato
qualche riga sopra.

NB: baccan.it non memorizza il vostro indirizzo di email per capire se
e' la prima mail che inviate nella giornata, ma il crypt della mail. In
questo modo  nessun dato sensibile e' registrato, dato che crypt non e'
reversibile e non  si puo' quindi tornare alla stringa che ha generato
quel crypt. Potete analizzare il codice guardando il file phpproxy.zip
allegato a HTML2POP3.

baccan.it si limita a memorizzare il nome del server utilizzato, in modo
da aggiornare la lista dei server POP3 mondiali con i quali e' possibile
utilizzare  la modalita' di tunneling. Tale lista viene utilizzata
nelle successive release per semplificare l'utilizzo del programma
tramite tunnelpop3.cfg

Per meglio capire quanto sia potente questo plugin, ecco una
lista delle email che e' possibile controllare tramite il plugin
generico POP3:

Per gestire la posta su Email.it

Login   : pop3;TUA_EMAIL@email.it;popmail.email.it
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su katamail.it

Login   : pop3;TUA_EMAIL@katamail.it;mail.katamail.com
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su Yahoo.it

Login   : pop3;TUA_EMAIL;pop.mail.yahoo.it
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

NB: per usare questo servizio e' necessario attivare l'uso
di POP3 sulla casella Yahoo.it, come indicato qui

http://help.yahoo.com/help/it/mail/pop/pop-07.html

fatto questo funzionera' tutto, ho provato

Per gestire la posta su Poste.it

Login   : pop3;TUA_EMAIL@poste.it;relay.poste.it
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su Aruba.it

Login   : pop3;TUA_EMAIL;pop3.aruba.it
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

Per gestire la posta su Vodafone.it

Login   : pop3;TUA_EMAILpopmail.vodafone.it
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato



SUPPORTO COMPLETO - mail emulata
--------------------------------
Con questi plugin e' possibile attivare anche la cancellazione
in quanto il loro supporto e' completo
Attenzione pero', rispetto ai plugin precedenti, la mail e'
ricostruita da 0, quindi ci potrebbero essere dei problemi
al cambio di interfaccia web da parte del service provider.
Ricostruire una mail significa, prendere le pagine HTML che
la visualizzano, lato web, e ricreare un messaggio POP3.
Per questa ragione si consiglia di attivare l'opzione

htmlattach=true

nel config.cfg, in modo da avere, per ogni email, l'email stessa
in attach. Un piccolo backup in caso di problemi

Per gestire la posta su aliceposta.it

Login   : aliceposta.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato
PROBLEMI: email emulata

Per gestire la posta su supereva.it, freemail.it
   freeweb.org, cicciociccio.com, mybox.it, mp4.it,
   superdada.com, clarence.com

Login   : supereva.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato
PROBLEMI: email emulata

Per gestire la posta su tim.it

Login   : tim.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato
PROBLEMI: email emulata

Per gestire la posta su tiscali.it

Login   : tiscali.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato
PROBLEMI: email emulata

Per gestire la posta su tele2.it

Login   : tele2.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato
PROBLEMI: email emulata


Per gestire la posta su linux.it

Login   : linux.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato
PROBLEMI: email emulata


SUPPORTO PARZIALE
-----------------
Di seguito vengono riportati I plugin utilizzabili solo
in modalita' "lascia la copia sul server", dato che non
prevedono ancora la cancellazione della mail, in quanto non
completi. Manca infatti il supporto per gli attach e per alcuni
parametri dell'header

Per gestire la posta su fastwebnet.it

Login   : fastwebnet.it;la vostra login
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato
PROBLEMI: manca la cancellazione

Per gestire la posta su gmail.com

ATTENZIONE .. ci sono ancora problemi

Login   : la_vostra_login@gmail.com
Password: la vostra password
Server  : localhost, o l'indirizzo che avete configurato
Porta   : 110, o la porta che avete configurato

IMPORTANTE: dovete mettere, in configurazione di gmail

"Attiva POP per tutti i messaggi (anche i messaggi gia' scaricati)"

altrimenti la cosa non funziona

e aggiungi

gmail.com=pop3;%email%;ssl://pop.gmail.com;995

nel tunnelpop3.cfg


TENTATIVO DI SUPPORTO
---------------------
Ci sono dei plugin in preparazione che NON vanno, ma era carino
inserire gli sforzi che vengono fatti. Non usateli, ma guardate il
work in progress



REGOLE GENERALI
---------------
In generale, il server (html2pop3) necessita di un prefisso, nelle impostazioni
del vostro client di posta (eudora, outlook), dato dal server da
contattare piu' punto e virgola e l'utente da utilizzare. In questo modo
e' in grado di utilizzare il plugin corretto e attivare piu' servizi
POP3 diversi, utilizzando un solo server su una sola porta POP3

Dalla versione 1.17 e' pero' stato introdotto un nuovo algoritmo di
riconoscimento in grado di determinare il login anche senza il prefisisso,
se nel login e' compreso il nome del server.
Ad esempio

libero.it;TUA_EMAIL@libero.it

puo' essere inserito in configurazione semplicemente come

TUA_EMAIL@libero.it

e tutto dovrebbe funzionare allo stesso modo

Client testati
--------------
Outlook Express, Mozilla, Eudora Pro, Microsoft Outlook (2003)
Pegasus (4.12a), safari su Mac con os x 10.2.8, TheBat! v2.0
IncrediMail XE, Pmmail, Foxmail 5.0 beta 2, Fort Agent 1.93,
K9 (http://keir.net). M2, THE BAT! 2.01.3, Netscape 7.1,
Mail 1.3 (v606) su Mac OS X 10.3, Mail 1.2.5 (v552) su Mac OS X 10.2
Calypso, nPOPQ, KMail (1.5.4), evolution (1.4.5),
fetchmail release 6.2.3+RPA+NTLM+SDPS+SSL+NLS, HAMSTER 2.0.0.1
FarMail, MailWasher Pro 4.0, Mcafee Spam Killer 5.0


Parametri del config.cfg
========================
Di seguito sono presenti le spiegazioni di come modificare il file
di configurazione config.cfg presente nella directory di html2pop3


# E' l'indirizzo che deve utilizzare il server per attivarsi. Se usate
# solo sulla vostra macchina il programma indicate localhost o 127.0.0.1
# se lo volete usare come server di rete, mettere l'IP di rete della macchina

host=localhost

# Porta da usare, normalmente 110, ma se avere un antivirus recente
# potrebbe essere usata come porta, in quel caso usate 111

port=110

# se delete=false, la posta non verra' mai cancellata, se delete=true
# I comandi di cancellazione andranno a buon fine se invocati

delete=false

# se deleteoptimized=false, l'eventuale cancellazione della posta da parte
# di html2pop3 verra' fatta prima di mandare l'OK al client remoto
# lasciato un true, prima viene sganciato il client remoto e poi
# html2pop3 continua con le cancellazioni. Questa tecnica aumenta
# le performance dei client che vengono subito sganciati e non
# devono attendere la cancellazione della posta per passare al successivo
# account da controllare, tanto a cancellare ci pensa html2pop3

deleteoptimized=true

# Indirizzo IP del server proxy, normalmente usato in lan aziendali

proxyhost=

# porta del server proxy, normalmente usato in lan aziendali

proxyport=

# utente e passowrd del proxy, in caso di richiesta di autentificazione

proxyuser=
proxypassword=

# e' il numero di client che, in contemporanea, possono usare html2pop3
# puo' essere utile variare questo valore nel caso che html2pop3 faccia
# da server per un numero maggiore di macchine

concurrentclient=50

# E' possibile definire che tipo di coda gestire per i messaggi entranti
# se usare la lifo (default) i primi messaggi scaricati sono i piu' recenti
# o fifo, i primi scaricati sono i pi vecchi.

coda=lifo

# E' possibile indicare che i server che funzionano in emulazione POP3
# aggiungano alla mail emulata, il sorgente HTML originale della mail
# web che viene utilizzata per estrarre i valori di from/to/etc etc
# il default e' true, per avere la massima certezza di non perdere la posta

htmlattach=true

# E' possibile eliminare lo sponsor che appare nella email emulate
# Il default e' sponsor=true, in modo che appaia sempre

sponsor=false

# Indica il numero massimo di email da scaricare ad ogni sessione.
# Puo' essere utile su caselle particolarmente piene.
# Il default e' -1 e indica che occorre scaricare tutta la posta.
# Un altro valore limita il numero massimo di email scaricabili nella
# sessione

maxdownloadpersession=5

# Indica la dimensione del file di log, prima che venga rinominato in
# .old e rimpiazzato da un nuovo file di log. Questo settaggio serve
# ad evitare file di log immensi

logsize=1000000

# Flag specifico per tiscali. Se uguale a "false" la cancellazione delle
# mail su tiscali provoca solo il loro spostamento nel cestino.
# Se "true" invece la cancellazione della mail provoca una cancellazione
# fisica dal server, esattamente come nella realta'

tiscali.delete=false

# C'era uno stranissimo errore sul comando STAT. Con outlook 2002 non
# si riusciva a mandare il risultato di STAT da HTML2POP3 al client.
# Stavo veramente impazzendo, quando google mi ha ispirato.
# In pratica se la risposta del server e' troppo veloce, outlook 2002
# perde la risposta. Per evitare il problema ho introdotto un delay di
# 1 secondo nella risposta di STAT. Se la cosa vi da fastidio e non
# volete neppure sprecare questo secondo .. prendete questa riga
# e mettetela nel config.cfg, togliera' questo inutile delay da html2pop3

outlook2002.timeout=false

# porta da usare per il server SMTP. Se non indicato assume il valore di
# default di 25

portsmtp=25

# porta da usare per il server NNTP. Se non indicato assume il valore di
# default di 119

portnntp=119


#
# Filtro su plugin per server POP3
# I filtri devono chiamarsi
#
# pop3.pluginfilter  + progressivo da 1 a N
#
# Ogni filtro puo' ammettere o bloccare un certo plugin
# Se il filtro inizia con allow il plugin e' ammesso
# Se il filtro inizia con deny il plugin non e' ammesso
#
# I filtri sono controllati in sequenza, quindi, il controllo
# esce alla prima verificata
#
# I tipi di controlli sono fatti in 2 modalita'
#
# Verifica su singolo plugin. In questo caso il plugin libero.it e' abilitato
pop3.pluginfilter1=allow;libero.it

# Verifica per qualsiasi plugin. In questo caso, qualsiasi plugin, viene bloccato
pop3.pluginfilter2=deny;all

#
# Filtro su utente per server POP3
# I filtri devono chiamarsi
#
# pop3.userfilter  + progressivo da 1 a N
#
# Ogni filtro puo' ammettere o bloccare un account di posta
# Se il filtro inizia con allow l'indirizzo e' ammesso
# Se il filtro inizia con deny l'indirizzo non e' ammesso
#
# I filtri sono controllati in sequenza, quindi, il controllo
# esce alla prima verificata
#
# I tipi di controlli sono fatti in 2 modalita'
#
# Verifica su singolo utente. In questo caso l'indirizzo che INIZIA per pippo
pop3.userfilter1=allow;pippo

# Verifica per qualsiasi utente. In questo caso, qualsiasi utente, viene bloccato
pop3.userfilter2=deny;all

#
# Filtro su ip per server POP3
# I filtri devono chiamarsi
#
# pop3.ipfilter  + progressivo da 1 a N
#
# Ogni filtro puo' ammettere o bloccare un indirizzo IP
# Se il filtro inizia con allow l'indirizzo e' ammesso
# Se il filtro inizia con deny l'indirizzo non e' ammesso
#
# I filtri sono controllati in sequenza, quindi, il controllo
# esce alla prima verificata
#
# I tipi di controlli sono fatti in 3 modalita'
#
# Verifica su singolo IP. In questo caso l'indirizzo localhost e' ammesso
pop3.ipfilter1=allow;127.0.0.1

# Verifica su gruppo di IP. In questo caso la sottorete 192.168 e' ammessa
pop3.ipfilter2=allow;192.168

# Verifica per qualsiasi IP. In questo caso, qualsiasi IP, viene bloccato
pop3.ipfilter3=deny;all


#
# Permette di creare una regola generale, che scaturisce dall'allineamento
# di tre valori: IP, plugin e user
# in questo modo si possono creare delle regole generali che valgono
# solo per alcune situazioni, o singoli utenti
#
pop3.globalfilter1=allow;127.0.0.1;libero;pippo
pop3.globalfilter2=deny;all


#
# Stesse regole di pop3.pluginfilter
#
smtp.pluginfilter1=allow;smtp
smtp.pluginfilter2=deny;all

#
# Stesse regole di pop3.userfilter
#
smtp.userfilter1=allow;pippo
smtp.userfilter2=deny;all

#
# Stesse regole di pop3.ipfilter
#
smtp.ipfilter1=allow;127.0.0.1
smtp.ipfilter2=allow;192.168
smtp.ipfilter3=deny;all

#
# Stesse regole di pop3.globalfilter
#
smtp.globalfilter1=allow;127.0.0.1;libero;pippo
smtp.globalfilter2=deny;all

#
# Stesse regole di pop3.ipfilter
#
nntp.ipfilter1=allow;127.0.0.1
nntp.ipfilter2=allow;192.168
nntp.ipfilter3=deny;all


FAQ
---

D: a volte non scarica piu' la posta, poi riprovo e funziona. Oppure
   il programma smette totalmente di funzionare. Cosa devo fare?

R: Prima di tutto verifica che non ci sia una versione nuova sul sito
   se c'e' installala, altrimenti rispova dopo qualche ora. A volte
   ci sono dei disservizi, se invece il problema e' HTML2POP3, prima o
   poi verra' aggiornato sul mio sito


D: Quando lancio html2pop3.bat non viene trovato javaw.exe. Cosa devo fare?

R: In questo caso deve essere installato il JDK o il JRE 1.4.2.
   che si trova al sito http://java.sun.com

   http://java.sun.com/j2se/1.4.2/download.html

   Il file da prendere e'

   "Download J2SE v 1.4.2_02" - "Windows Installation"  "JRE"

   Dopo l'installazione, occorre verificare di avere javaw in path,
   l'installazione dovrebbe metterlo nella cartella Windows, quindi non
   ci dovrebbero essere grossi problemi



D: Durante la fase di connessione ho l'errore java.net.connectexception:
   connection timed out Cosa puo' essere?

R: Ci sono vari casi in cui il software piu' andare in timeout

   1) Non riesce a contattare il proxy. In questo caso e' meglio mettere
      un IP al posto di un nome DNS

   2) Il get della mail dura troppo tempo. In questo caso e' meglio
      aumentare il timeout di sessione sul profilo di Outlook


D: Voglio usare spam terminator con HTML2POP3. Come faccio?

R: Per usare spam terminator con HTML2POP3 devi mettere spam terminator
   in ascolto sulla porta 111 e HTML2POP3 sulla 110. Poi configuri il server
   POP3 sulla porta 111 e come account imposta

   il_tuo_account#127.0.0.1

   in modo che la sequenza sia: spam terminator porta 111 -> HTML2POP3 porta 110


D: Spesso il programma di posta mi da il seguente errore:

   Il server ha interrotto la connessione in modo inatteso. Ci potrebbe
   essere dovuto a problemi relativi al server o alla rete oppure a un
   lungo periodo di inattivit. Account: 'popmail.libero.it', Server:
   'localhost', Protocollo: POP3, Porta: 110, Protezione (SSL): No,
   Errore socket: 10054, Numero di errore: 0x800CCC0F


R: Hai un messaggio grosso in coda. Prova ad aumentare il timeout di outlook

   Vai alla voce "strumenti" e poi "account"
   Scegli l'account e su "impostazioni avanzate" sposta
   il "timeout del server" ad un valore piu' alto .. tipo .. 10 minuti
   Dovrebbe andare tutto a posto


D: HTML2POP3 supporta? spamihilator

R: Supponendo che la configurazione sia

   outlook -> antispam porta 110 -> html2pop3 porta 111 -> html libero

   scrivi

   localhost&libero.it;tuo_utente&111

   dovrebbe andare tutto


D: volendo usare il software su una piccola rete di cui solo un computer
   dispone di una connessione condivisa ad internet, come posso
   impostare il tutto in modo da eseguire il software solo sul computer
   che dispone della connessione e di permettere per l'accesso alla
   posta da parte di tutti i client senza eseguire il suo programma su
   ogni computer?

R: Per dare il servizio a tutti, mettilo sul server, come ip non mettere
   localhost, ma l'ip del server .. e sui client lo stesso, non usare
   piu' localhost, ma l'ip del server, dovrebbe andare tutto al primo
   colpo


D: Vorrei scaricare anche la posta, non e' che HTML2POP3 puo' fare anche
   da server SMTP.

R: Dalla versione 2.00 questo e' possibile. Imposta come server SMTP
   il server localhost sulla porta 25


D: Voglio mettere in autostart il tuo programma come faccio?

R: Semplice, crea il file autostart.reg e scrivici

------------8<-------------------------8<-------------
REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run]
"pop3 Server"="c:\\html2pop3\\html2pop3.EXE -config c:\\html2pop3\\config.cfg"
------------8<-------------------------8<-------------

   modificando col percorso del programma
   Poi lancia il .reg e tutto sara' messo in partenza automatica


D: Voglio usare norton antivirus. Come lo configuro?

R: Per poterlo usare con Norton Antivirus 2001 devi

   1) mettere HTML2POP3 su porta 2000 (da file config)
   2) mettere pop3.norton.antivirus come server POP3
   4) mettere come utente:

   libero.it;TUA_EMAIL@libero.it/127.0.0.1:2000

   e tutto dovrebbe andare


D: HTML2POP3 non cancella la posta e me la riscarica 2 volte

R: Per come e' progettato HTML2POP3, le cancellazioni vengono
   fatte DOPO che il client di posta si stacca da HTML2POP3.
   In pratica, la cancellazione viene messa in un vettore di
   messaggi da cancellare e lo smaltimento di questo vettore
   viene fatto dopo il comando QUIT del client.
   Questo modo di agire permette un QUIT immediato, ma carica
   lascia attivo un processo sul server che cancella la posta.
   Cosa puo' capitare? che, mentre il processo su HTML2POP3 sta
   ancora cancellando, un client faccia una nuova richiesta.
   In questo caso, potrebbe leggere della posta appena letta,
   dato che il server la sta ancora cancellando.
   Per mitigare questo problema, e' stato introdotto un settaggio
   all'interno di config.cfg: deleteoptimized. Se tale campo
   e' impostato a true

   deleteoptimized=true

   la cancellazione e' ottimizzata, se a false

   deleteoptimized=false

   la cancellazione viene fatta prima della restituzione del
   valore +OK sul comando QUIT impartito dal client di posta.
   Questo rallenta il logout del client di posta, ma garantisce
   il fatto di non scaricare due volte la posta in caso di
   due check ravvicinati.


D: Ho un firewall non riesco a usare HTML2POP3.

R: Se usate un firewall, come Kerio Personal Firewall o altri,
   ricordatevi di sbloccare HTML2POP3, permettergli di attivare
   un server sulla porta 110 o di inserire una regola che permetta
   una connessione TCP attraverso la porta 80.


D: Bello il tuo programma, ma riesco solo a mandare e non a ricevere
   la posta.
   Ho provato anche a usare in server SMTP, ma ho ricevuto questo errore

   '550 RCPT TO:<xxxx@xxxx.it> Relaying not allowed'

   oppure

   'Inoltro negato, Relay not Allowed'

R: Se non riesci a far uscire la posta, ci sono tre ragioni plausibili

   1) Stai usando un server SMTP sbagliato, quindi non quello del tuo
   provider. Magari usi una una linea ADSL come alice e mandi la posta
   col server SMTP di libero. In questo caso metti il server SMTP del
   tuo provider

   2) Non ti stai autentificando al server SMTP. Se e' questo il caso,
   vai nelle proprieta' dell'account, dove viene indicato il server SMTP
   Specifica che il server necessita di autentificazione e indica, come
   account e password, il tuo account e password. Nel caso di libero
   dovrebbe essere

   smtp.libero.it

   e come login e password

   TUA_EMAIL@libero.it
   tua_password

   sostituendo a tua_login e tua_password i valori corretti
   In questo modo dovresti riuscire a mandare senza problemi.

   3) Non hai un server SMTP disponibile. In questo caso puoi usare il
   server SMTP interno di HTML2POP3. Imposta il server SMTP su
   localhost, sulla porta 25. Pensera' a tutto HTML2POP3.
   ATTENZIONE: questo metodo permette di mandare posta ma e' sicuramente
   piu' lento dell'uso diretto di un server SMTP reale

   Volendo, a questo indirizzo http://www.dotnethell.it/tips/0x800CC79.aspx
   e' presente un buon tutorial sul come risolvere i problemi


D: Vorrei usare il plugin POP3 generico, come posso fare?

R: Dalla versione 1.24 e' possibile utilizzare un plugin generico POP3
   che permette di ponteggiare su un server HTTP, prima di accedere alla
   casella POP3. Questo tipo di "ponte" permette di usare, virtualmente
   qualsiasi casella POP3 senza restrizioni, in tutti i casi in cui i
   si trovi in un'azienda dotata di firewall che non permette di uscire
   su una porta diversa da quella HTTP

   La configurazione e' molto semplice, basta procedere nel seguente modo
   Configurare HTML2POP3 come server, come al solito
   Poi, mettere, come login la propria login e come account una stringa
   formattata nel seguente modo:

   pop3;nome_utente;server_pop3;porta

   ad esempio

   pop3;poppo_pluto;pop3.mioserver.it;110

   la richiesta verra' ponteggiata sul mio sito http://www.baccan.it
   e poi riponteggiata sul server pop3.

   Dato che le password e i dati passano in chiaro sul mio server, e che non
   ho la certezza matematica di poter dare il servizio per sempre, vi
   consiglio comunque di prendere il file pop3php.zip e installare i due
   file PHP che troverete in questo zip su un vostro server.
   A questo punto potete modificare l'indirizzo di posta in

   pop3;poppo_pluto;pop3.mioserver.it;110;http://www.vostroserver.it/miadir/

   e il programma poteggera' sul vostro server e non piu' sul mio.


D: Come posso usare email.it?

R: Dalla versione 2.20 puoi semplicemente impostare:

   server: localhost
   porta: 110 ... oppure la porta che hai usato in configurazione
   utente: TUA_EMAIL@email.it
   password: la tua password


D: Vorrei mandare degli SMS a numeri vodafone, come posso fare

R: Per mandare SMS a numeri vodafone, basta che ti registri
   gratuitamente sul server www.190.it, e, tramite l'account di
   posta che hai usato per la registrazione, mandi un sms formattato
   nel seguente modo

   NUMERO_CELLULARE@sms.vodafone.it

   ad esempio

   3479999999@sms.vodafone.it

   il subject della mail e il body verranno usati come testo dell'sms


D: Non riesco a connettermi usando HTML2POP3 e continuo a trovare
   questi errori nel file html2pop3.log

   java.net.ConnectException: Connection refused

   oppure

   java.net.UnknownHostException: wpop1.inwind.libero.it

   oppure

   java.net.NoRouteToHostException: Operation timed out

   Cosa puo' essere?

R: Probabilmente hai un personal firewall che non ti permette di
   chiamare  le pagine remote che vengono usate da HTML2POP3. Abilita
   HTML2POP3 nel tuo personal firewall. L'errore puo' essere dovuto
   anche a un aggiornamento di HTML2POP3. Avevi certificato la versione
   precedente, ma non la nuova.
   NB: Problema riscontrato con il firewall Norton


D: Non riesco a connettermi usando HTML2POP3 e continuo a trovare
   questi errori nel file html2pop3.log

   java.io.FileNotFoundException: http://www.baccan.it/pop3/postmsg.php

   oppure

   java.io.FileNotFoundException: http://wpop20.libero.it/email.php

   Cosa puo' essere?

R: Probabilmente sta usando un proxy autentificato e HTML2POP3 non
   riesce ad usarlo, oppure hai sbagliato la login e la password, oppure
   non l'hai messa per nulla. Controlla meglio la configurazione del
   proxy
   ATTENZIONE: se il tuo utente utilizza la sintassi

   DOMINIO\UTENTE

   per un problema di lettura del file config.cfg, la barra deve essere
   messa doppia

   DOMINIO\\UTENTE

   la configurazione diventera' quindi

   proxyuser=DOMINIO\\UTENTE

   o per voler fare un esempio

   proxyuser=workgroup\\pippo


D: Come posso disabilitare il server POP3 o SMTP o NNTP di HTML2POP3?

R: Se metti 0 come porta di POP3 o SMTP o NNTP disabiliti il servizio
   corrispondente

   portsmtp=0

   disabilita SMTP

   port=0

   disabilita POP3 e

   portnntp=0

   disabilita NNTP
   Ricorda che puoi modifica il file config.cfg "live" senza riavviare HTML2POP3


D: Il mio proxy ha un'autentificazione NTLM, come posso utilizzare HTML2POP3

R: Per autentificarti in NTLM puoi usare due tecniche diverse.

   Se utilizzi versione portabile di HTML2POP3, con Java versione 1.4 o
   superiore, e lo utilizzi su una macchina Windows, puoi modificare il
   file config.cfg il tuo nome utente con questa  sintassi:

   nome_del_dominio\\nome_utente

   attenzione: devi mettere 2 volte la barra.
   Fatto questo e, chiaramente, messa anche la password, il programma funzionera'
   In alternativa puoi installare un proxy bridge di autentificazione NTLM

   http://sourceforge.net/projects/ntlmaps/

   in pratica, fai connettere HTML2POP3 a NTLMAPS che si connette al tuo proxy
   con autentificazione NTLM e in questo modo puoi far uscire HTML2POP3 senza
   problemi
   Per maggiori informazioni http://ntlmaps.sourceforge.net/


D: Ho copiato le pagine PHP per il tunneling sul mio sito e non funzionano. Come
   mai?

R: Quando meti le pagine PHP sul tuo sito devi assicurarti che sia possibile fare
   una connessione SOCKET fra PHP e i server remoti
   Alcuni provider permettono PHP, ma non permettono connessioni SOCKET remote

   Per questa ragione, e per altre, le pagine PHP non funzionano con:

   1) Altervista.org = socket chiuse
   2) Lycos = modifica del risultato delle pagine
   3) web.tiscali.it = non esegue script php
   4) home.tele2.it = non esegue script php


D: Posso usare PC Cillin con HTML2POP3?

R: PC Cillin permette il controllo di server POP3 che usano la porta 110.

   http://www.trendmicro.com/ftp/documentation/readme/readme-pcc2005.txt

   Per questa ragione, dovendo far convivere sullo stesso PC HTML2POP3 e
   PC-Cillin e non potendo usare tutti e due la stessa porta 110 (salvo
   configurazioni multiIP, ma  andrebbe verificata la cosa), non e'
   possibile usare HTML2POP3 con PC Cillin.

   Chiaramente il problema si risolve automaticamente, spostando HTML2POP3
   su un server e usando PC Cillin locale


Q: Ciao, usando HTML2POP3 con Windows 95 trovo il seguente errore nel log

   24/02/2005 14:56:25 [780032] java.lang.UnsatisfiedLinkError:
   C:\Programmi\Java\j2re1.4.2_01\bin\net.dll:
   Impossibile trovare uno dei file della libreria
   necessari per eseguire l'applicazione

   cosa puo' essere?

R: Sembra che il sistema non riesca a caricare la net.dll su windows 95.
   Credo che questo accada perche' windows 95 non supportava ancora
   winsock 2

   Per risolverlo devi aggiornare il sistema operativo con winsock 2.
   Prova con windows  update, sempre che ci sia questo aggiornamento,
   oppure prova a installare questo file

   http://ftp.tuniv.szczecin.pl/pub/windows/Win95/winsock-l/Develop/ws295sdk.exe

   il sito non e' quello ufficiale Microsoft, perche' pare non esistere
   piu' il file su www.microsoft.com


Q: HTML2POP3 non mi scarica la posta. Ha funzionato solo la prima volta.

R: Controlla di avere HTML2POP3 in partenza automatica, se non hai impostato
   la partenza automatia, devi ricordati di lanciare HTML2POP3 alla partenza del
   tuo PC


Q: HTML2POP3 non vede i messaggi nuovi.

R: Se stai usando la posta in modalita': "lascia la copia sul server", devi
   fare attenzione a non cancellare messaggi da Web o a scaricare i messaggi
   da casa o da un altro PC, perche' cosi facendo perdi la sincronia fra
   la casella di posta e il tuo client di posta che non scarica i messaggi,
   ma si limita a sincronizzarli in locale.
   In questo caso, per tornare a una situzione consistente, ricrea l'account
   sul tuo client di posta, oppure salvarlo e ricaricalo, e tutto tornera'
   a funzionare.


Q: Quando forwardo dei messaggi scaricati da tin.it e virgilio.it, non vengono
   ricevuti dal destinatario

R: Alcuni utenti hanno riportato che, aggiungendo questa riga al config.cfg

   htmlattach=false

   il problema si risolva


Q: Come posso utilizzare html2pop3 come servizio di sistema? in modo da averne
   una sola istanza per tutti gli utenti presenti sulla macchina dove e'
   installato, o semplicemente per avviarlo in modo automatico su un server?

R: Per rendere html2pop3 un servizio NT basta scaricare WINSERV, da questo
   indirizzo:

   http://sw4me.com/wiki/Winserv?v=qw0

   A questo punto scrivendo

   winserv.exe install html2pop3 -start auto html2pop3.exe

   viene creato un servizio di nome "html2pop3 (managed by WinServ)" in
   partenza automatica.
   In questo modo, al riavvio della macchina, html2pop3 verra' caricato
   in modo automatico.

   Per rimuovere il servizio, bastera' poi scrivere

   winserv.exe uninstall html2pop3

   ATTENZIONE: in questo caso, il log prodotto da html2pop3, potrebbe
   non essere nella directory del programma e trovarsi in un'altra directory.
   Su alcuni sistemi, il log e' presente in

   C:\WINNT\system32\html2pop3.log



TODO in ordine di priorita'
---------------------------
Google GMail support (in lavorazione). Potrebbe non servire, dovrebbe bastare il
tunneling

Parametro per gestire il path del file di log

Migliorare fastweb

Aggiunta di nuovi plugin in ordine di priorita'
   http://www.lycos.it    (attualmente usabile con plugin pop3)
   http://www.yahoo.it    (attualmente usabile con plugin pop3)
   http://www.kataweb.it  (attualmente usabile con plugin pop3 mail.katamail.com)
   www.itloox.com
   GSMbox
   http://www.operamail.com
   interfree
   infostrada
   inbox.Excite.it
   ciaoweb.it,
   vivacity.it
   www.hackermail.com
   msn,
   enel.it .. in generale exchange
   mail.com,
   zzn.com,
   Iname.com
   punto.it
   neomail
   netscape mail
   MDaemon (http://wwwaltncom)
   www.horde.org
   freepass.it
   www.micso.net
   http://www.gmail.com        (1gb)
   http://www.walla.com        (1gb)
   http://mail.rediff.com      (1gb)
   http://www.manager.it       (1gb)
   http://www.aventuremail.com (2gb)
   http://www.spymac.com       (3gb)
   http://myquickmail.us       (3gb)   (pop3 plugin)
   http://hellaciousriders.com (100gb)

Versione come service: e' fattibile ..

Mutex per i pigri

Resize del frontend java da migliorare e aggiungere warning in uscita

Virtual POP3 .. un pop3 grosso grosso che dentro controlla X caselle

Supporto per IMAP

In caso di cartelle non vede i messaggi delle altre cartelle


Ringraziamenti
--------------
Un rigraziamento a tutti coloro che mi stanno sostenendo in questo progetto e
che continuano a mandarmi feedback sul programma

Ringrazio www.alienproductions.it per la prima stesura del tutorial e
tutti coloro che hanno collaborato riportando le loro esperienze


Alternative
-----------
HTML2POP3 non e' l'unico programma di questo tipo. Per chi volesse un
alternativa, provate anche

http://freepops.sourceforge.net/it/ scritto in C e LUA per vari gestori
http://liberopops.sourceforge.net scritto in C per libero
http://www.geocities.com/marcopipino/main.htm in Visual basic per libero
http://yahoopops.sourceforge.net/ per yahoo
http://sourceforge.net/projects/hotpop3 per hotmail

Essendo programmi diversi sono stati progettati in maniera diversa e
fanno cose diverse e hanno bug diversi.

Cosa fa in piu' o in meno HTML2POP3? A voi scoprilo, non mi piace fare
il paladino dell'uno o dell'altro programma.

A voi capire qual'e' quello che preferite .. o magari li preferite
tutti. Sicuramente non mi offendo se non usate il mio programma, e ne
usate un altro spero almeno che vi possa essere utile per studiare come
funziona il protocollo POP3, SMTP, NNTP e HTTP

ciaooooooooooo

Potete trovare l'ultima versione di HTML2POP3 all'indirizzo:

http://www.baccan.it
