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 divisii tra più articoli diversi e newsgroup diversi; mentre i suoi attuali limiti sono: -NewsGreed non è in grado di riprendere uun download interrotto per intervento dell'utente o per un malfunzionamento del collegamento di rete; -manca il supporto per l'autenticazione ccon 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 messagggi MIME. Miglioramento dell'interfaccia utente: -Aggiunta una finestra di dialogo che eleenca tutti i newsgroup disponibili sul server selezionato; -Aggiunta una finestra di dialogo che eleenca 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 espplicitamente una directory di lavoro ed una directory di download; -Risolto qualche baco in giro per il codiice (grazie Thomas!); -Prima versione localizzata in Italiano ooltre 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 diirectory (cartella) dove si trova il file NewsGreed.jar ed eseguire: java -jar NewsGreed.jar -dall'interfaccia grafica, fare doppio cllick 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 usandoo la lista Nome dei newsgroup; -se tenendo premuto il tasto SHIFT fai cllick 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 allla lista, premi il bottone Aggiungi un nuovo newsgroup... ed inserisci il nome del newsgroup nella finestra che appare; -premi il bottone Scegli newsgroup... perr 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 suubject 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 ffile 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 suddivvisi 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 suddiiviso 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 giiù) permette di cercare un newsgroup il cui nome contenga una data stringa; -il bottone Aggiorna scarica i nuovi newssgroup aggiunti al server (in NewsGreed 0.4 questa caratteristica non è ancora implementata!); -la lista contiene tutti i newsgroup dispponibili sul server; -il bottone Aggiungi alla lista di newsgrroup 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 nnewsgroup 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 giiù) permette di cercare un articolo il cui subject contenga una data stringa; -il bottone Aggiorna scarica i nuovi artiicoli aggiunti al newsgroup; -la lista contiene tutti gli articoli dissponibili sul newsgroup; -se tenendo premuto il tasto SHIFT fai cllick 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 visuualizzare 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, ill suo subject è copiato nel campo di testo sottostante; -il bottone Aggiungi alla stringa di riceerca 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 - [] Il significato dei parametri è il seguente: -s indica di ricercare file suddivisi; -w indica di ricercare file pubblicati inn un singolo articolo; è l'indirizzo del server NNTP; è la porta del server NNTP; è la lista dei newsgroup (separati da virgole) all'interno dei quali effettuare la ricerca; è una lista opzionale di stringhe (separate da virgole) da ricercare all'interno del subject degli articoli.