NewsGreed 0.4.5
http://www.geocities.com/NewsGreed/
Copyright (C) 2002 - 2004 Leonardo Ferracci


Una breve introduzione a NewsGreed
==================================

NewsGreed  una semplice applicazione concepita per automatizzare il download di file binari dai newsgroups; alcune tra le sue caratteristiche sono: 
-definizione di filtri per selezionare i file da scaricare (sulla base del subject del relativo articolo); 
-selezione dei tipi di file (estensioni) da scaricare; 
-ricostruzione automatica dei file divisi tra pi articoli diversi e newsgroup diversi; 

mentre i suoi attuali limiti sono: 
-NewsGreed non  in grado di riprendere un download interrotto per intervento dell'utente o per un malfunzionamento del collegamento di rete; 
-manca il supporto per l'autenticazione con nome utente e password (per i server che la richiedono). 


Novit della versione 0.4.4 - 0.4.5
===========================
Eliminati alcuni bachi!

Novit della versione 0.4.3
===========================
-Aggiunta la possibilit di elencare gli articoli di un newsgroup direttamente dalla finestra dei Newsgroup;
-Aggiunta la possibilit di scaricare un singolo articolo o un singolo file suddiviso direttamente dalla finestra di dialogo Lista articoli;
-I soliti bachi risolti...

Novit della versione 0.4.2
===========================
Eliminati bachi qua e l...

Novit della versione 0.4.1
===========================
Migliorata la velocit di elaborazione della finestra di dialogo Lista articoli.

Novit della versione 0.4
===========================
Bug risolti:
-Eliminato un malfunzionamento con messaggi MIME.
Miglioramento dell'interfaccia utente:
-Aggiunta una finestra di dialogo che elenca tutti i newsgroup disponibili sul server selezionato;
-Aggiunta una finestra di dialogo che elenca tutti gli articoli nel newsgroup selezionato, con la possibilit di mostrare solo gli articoli che contengono file suddivisi'


Novit della versione 0.2.2
===========================
-Aggiunta la possibilit di scegliere esplicitamente una directory di lavoro ed una directory di download;
-Risolto qualche baco in giro per il codice (grazie Thomas!);
-Prima versione localizzata in Italiano oltre a quella standard Inglese.

Novit della versione 0.2.1
===========================
-Ora NewsGreed funziona DAVVERO con post yEnc!!! Il relativo bug sulla decodifica di file multipart  stato eliminato;
-Risolte alcune interazioni non corrette con la finestra di dialogo dei newsgroup.

Novit della versione 0.2
=========================
Rispetto alla versione 0.1, in NewsGreed 0.2 sono presenti i seguenti miglioramenti:
-Interazione con l'utente: 
 -Un posizionamento pi razionale delle finestre; 
 -Aggiunta di finestre di conferma quando si interrompe un download o si chiude l'applicazione con un'operazione di download in corso (questo evita il rischio di abortire accidentalmente un enorme download soltanto per aver cliccato nel posto sbagliato!); 
 -Introduzione di una versione a riga di comando (con un limitato insieme di opzioni disponibili);
-Supporto ai newsgroup: 
 -Aggiunta la possibilit di cercare in pi di un newsgroup per ogni operazione - cos se alcune parti di un determinato file mancano in un certo newsgroup ma lo stesso file  stato pubblicato in uno o pi altri newsgroup (cross-post), la probabilit di riuscire a scaricare il file integro aumenta; 
-Supporto alle codifiche (encoding): 
 -Aggiunto il supporto alla codifica MIME/Base64; 
 -Aggiunto un primo supporto alla codifica yEnc.


Manuale di NewsGreed
====================

0. Requisiti
NewsGreed  un programma scritto in Java, e richiede il JDK o JRE 1.3.0 o superiori installato sulla macchina per essere eseguito.

1. Installazione
Non  richiesta alcuna particolare procedura di installazione: basta copiare il file NewsGreed.jar nella directory di lavoro scelta per l'applicazione.

2. Esecuzione del programma
NewsGreed pu essere eseguito in due modi:

-dalla riga di comando, spostarsi alla directory (cartella) dove si trova il file NewsGreed.jar ed eseguire:
java -jar NewsGreed.jar

-dall'interfaccia grafica, fare doppio click sull'icona NewsGreed.jar (questo dovrebbe funzionare almeno per win e Solaris).

3. Impostazione dei parametri
Quando appare la finestra di NewsGreed, premi il bottone Server per impostare i parametri del server di news (indirizzo e porta): questi parametri dovrebbero essere forniti dal provider Internet (ad esempio: server news.mioisp.it, porta 119).
Quindi premi il bottone Newsgroup per impostare i parametri relativi ai newsgroup:
-seleziona i newsgroup da scandire usando la lista Nome dei newsgroup;
-se tenendo premuto il tasto SHIFT fai click col pulsante destro su una voce della lista Nome dei newsgroup, un menu a comparsa ti permetter di elencare gli articoli presenti nel relativo newsgroup;
-se vuoi aggiungere un nuovo newsgroup alla lista, premi il bottone Aggiungi un nuovo newsgroup... ed inserisci il nome del newsgroup nella finestra che appare;
-premi il bottone Scegli newsgroup... per elencare tutti i newsgroup disponibili sul server selezionato - questo mostrer la finestra Lista dei newsgroup, v. 3.2 per maggiori dettagli;
-inserisci la stringa da ricercare nel subject degli articoli dei newsgroup: solo gli articoli binari il cui subject contiene la stringa inserita saranno scaricati -  anche possibile specificare una lista di stringhe separando le singole stringhe con una virgola (",") e SENZA SPAZI: cos saranno scaricati tutti gli articoli binari il cui subject contiene almeno una delle stringhe elencate. Inoltre  da tenere presente che il confronto avviene senza tenere conto di maiuscole e minuscole. 
Infine, se si lascia questo campo vuoto TUTTI gli articoli binari trovati saranno scaricati;
- possibile indicare le estensioni dei file che si vogliono scaricare (di nuovo, una lista di stringhe separate da virgole SENZA SPAZI), ad esempio "mp3,midi" o "jpeg,jpg,gif"; se si lascia questo campo vuoto saranno scaricati tutti i file (con QUALSIASI estensione).
-scegli se scaricare file che sono suddivisi tra due o pi articoli (molti server di news hanno limiti sulla dimensione massima degli articoli che rende necessaria questa soluzione quando si pubblicano file di dimensioni notevoli come file audio e video) o file pubblicati in un solo articolo binario (questo accade tipicamente per le immagini).
-se si sceglie di scaricare un file suddiviso tra due o pi articoli,  possibile che non tutte le parti siano presenti nei newsgroup selezionati; per scaricare comunque tutte le parti del file che  possibile trovare, si pu spuntare la casella Scarica frammenti di file incompleti.

3.1 Impostazione dei parametri di NewsGreed
NewsGreed permette di scegliere quale directory usare come directory di lavoro (dove sono salvate le liste degli articoli dei singoli newsgroup, divise in base al server) e quale usare come directory di download (dove sono salvati tutti i file binari scaricati).
Per default, NewsGreed usa la directory da cui  lanciato come directory di lavoro , e salva ogni file binario in una directory con lo stesso nome del newsgroup da cui  stato scaricato.
Per cambiare queste impostazioni, premi il bottone Impostazioni nella parte inferiore della finestra principale di NewsGreed: comparir una finestra di dialogo, in cui  possibile impostare la directory di lavoro e di download utilizzata dall'applicazione.

3.2 Finestra di dialogo Lista dei newsgroup
La finestra di dialogo Lista dei newsgroup elenca tutti i newsgroup disponibili sul server selezionato; se nessuna informazione  disponibile localmente, potrai scegliere se scaricarla dal server.
Le caratteristiche della finestra sono:
-il bottone Trova... (e Trova su/Trova gi) permette di cercare un newsgroup il cui nome contenga una data stringa;
-il bottone Aggiorna scarica i nuovi newsgroup aggiunti al server (in NewsGreed 0.4 questa caratteristica non  ancora implementata!);
-la lista contiene tutti i newsgroup disponibili sul server;
-il bottone Aggiungi alla lista di newsgroup da cui scaricare aggiunge i newsgroup selezionati alla lista di newsgroup dai quali scaricare file (nella finestra di dialogo Parametri newsgroup);
-il bottone Visualizza gli articoli nel newsgroup mostra la finestra di dialogo Lista articoli, che elenca tutti gli articoli disponibili nel newsgroup selezionato - v. 3.3 per maggiori dettagli.

3.3 Finestra di dialogo Lista articoli
La finestra di dialogo Lista articoli elenca tutti gli articoli presenti in un dato newsgroup; le caratteristiche di questa finestra sono:
-il bottone Trova... (e Trova su/Trova gi) permette di cercare un articolo il cui subject contenga una data stringa;
-il bottone Aggiorna scarica i nuovi articoli aggiunti al newsgroup;
-la lista contiene tutti gli articoli disponibili sul newsgroup;
-se tenendo premuto il tasto SHIFT fai click col pulsante destro su una voce della lista degli articoli, un menu a comparsa ti permetter di scaricare il singolo articolo o (se sono visualizzati gli articoli con file suddivisi - vedi sotto) l'intero file suddiviso;
-i bottoni sottostanti permettono di visualizzare tutti gli articoli nel newsgroup, o solo gli articoli che contengono file suddivisi, o solo gli articoli che contengono file suddivisi SENZA parti mancanti;
-selezionando un articolo dalla lista, il suo subject  copiato nel campo di testo sottostante;
-il bottone Aggiungi alla stringa di ricerca permette di aggiungere la stringa nel campo di testo alla stringa di ricerca nella finestra di dialogo Parametri newsgroup.

4. Lanciare e fermare un download
Una volta impostati  i parametri, premi il bottone Start per iniziare lo scaricamento automatico: prima saranno esaminati gli articoli nel newsgroup (raccogliendo informazioni dal server sui nuovi articoli), poi comincer il processo di download vero e proprio: due barre mostreranno lo stato di avanzamento del download complessivo e dello scaricamento del file corrente.
Se si vuole interrompere lo scaricamento, basta premere il bottone Stop.

5. Uso della versione a riga di comando
A partire dalla versione 0.2, nel file .jar  stata aggiunta una versione di NewsGreed a riga di comando; per estrarla, usa:
jar -xfv NewsGreed.jar *.class
e quindi lanciala con:
java clNewsGreed -<s|w> <server> <porta> <listanewsgroup> [<stringadiricerca>]
Il significato dei parametri  il seguente:
-s indica di ricercare file suddivisi;
-w indica di ricercare file pubblicati in un singolo articolo;
<server>  l'indirizzo del server NNTP;
<porta>  la porta del server NNTP;
<listanewsgroup>  la lista dei newsgroup (separati da virgole) all'interno dei quali effettuare la ricerca;
<stringadiricerca>  una lista opzionale di stringhe (separate da virgole) da ricercare all'interno del subject degli articoli.
