TestiMP3 – Guida all’uso
http://www.tranfaglia.org/testimp3/
Versione 1.08g © 2003-2011 Francesco Tranfaglia
Sommario
1. Che cos’è TestiMP3
2. Licenza d’uso e avvertenze
3. Requisiti di sistema
4. Installazione
4.1 Versione installabile
4.2 Versione portabile
5. Uso del programma
5.1 Avvio rapido da Esplora risorse
5.2 Avvio da riga comandi
6. Configurazione del programma
6.1 Impostazione dell'engine di sintesi vocale
6.2 Il file di configurazione
6.3 Parametri per il trattamento del testo
6.4 Parametri per le cartelle, i frammenti e il raggruppamento
6.5 Parametri per la sintesi vocale
6.6 Parametri per I file  MP3
6.7 Supporto ai dispositivi Apple
6.8 Altri parametri
6.9 Impostazioni di autore, titolo e nome file creato
7. Problemi di riproduzione
8. Revisioni
9. Ringraziamenti
1. Che cos’è TestiMP3
TestiMP3 è un programma di utilità che converte file di testo ASCII in file audio book MP3 o M4B che possono essere ascoltati anche con dispositivi portatili come riproduttori che supportano questi formati audio. È un programma a riga comandi, cioè che si avvia e si controlla dal Prompt dei comandi del sistema operativo MS-Windows. Può creare un singolo file audiobook da un file di testo oppure frammentarlo in blocchi di lunghezza definibile dall'utente. È possibile selezionare la lingua, i parametri della sintesi vocale e quelli di codifica della compressione sia attraverso la riga comandi che preimpostando un file di configurazione coi valori predefiniti. 
TestiMP3 supporta soltanto le sintesi vocali in standard ETI-Eloquence, ed è stato testato con quella fornita in dotazione con lo screen reader Jaws per Windows. Supporta sia i file in formato testo per Windows (codifica ANSI o UTF-8) che quelli per MS-DOS.
Il programma è ospitato su un sito, all'indirizzo  http://www.tranfaglia.org/testimp3/ dal quale è possibile scaricare la versione più aggiornata. Per essere informati degli aggiornamenti si può anche sottoscrivere la newsletter ospitata da YahooGroups inviando un messaggio vuoto e senza oggetto all'indirizzo testimp3-subscribe@yahoogroups.com e rispondendo al messaggio di conferma inviato dal sistema.
2. Licenza d’uso e avvertenze
TestiMP3 è stato sviluppato da Francesco Tranfaglia che lo mette a disposizione gratuita di chiunque abbia necessità di utilizzarlo.
Col programma non viene fornita alcuna sintesi vocale, e non funziona se sul computer dell'utente non ve n'è installata alcuna in standard ETI-Eloquence.
Il programma è fornito così com'è, senza alcuna garanzia per eventuali danni che possa causare all'utilizzatore il quale si assume tutte le responsabilità inerenti. L'autore non fornisce assistenza.
Col programma vengono distribuiti i seguenti componenti di terze parti:
•	Lame_enc.dll, facente parte del tool di sviluppo Lame Encoder per la codifica di file in formato MP3 e che è rilasciato sotto licenza GNU LGPL (http://www.mp3dev.org/, http://lame.sourceforge.net/license.txt).
•	RBSpeeexEnc.exe, proveniente dal progetto Rockbox http://www.rockbox.org, per la creazione delle etichette delle cartelle create sui dispositivi che adottano quel firmware open source.
•	La procedura di installazione è stata creata con Inno Setup, un potente tool opensource realizzato da Jordan Russell (http://www.jrsoftware.org/isinfo.php).
È possibile distribuire liberamente TestiMP3 da solo o in congiunzione con programmi anche commerciali, sia su supporto magnetico o ottico che via Internet. È fatto divieto esplicito di far circolare versioni beta del programma.
Tutti i marchi e i prodotti citati in questo documento e sul sito sono proprietà dei rispettivi autori.
3. Requisiti di sistema
Per utilizzare TestiMP3 occorre disporre di:
•	un computer con CPU Pentium o superiori e 32 Megabyte di RAM
•	sistema operativo Windows 9x/Me/2000/XP/Vista/7
•	un engine di sintesi vocale TTS compatibile con le specifiche ECI di ETI Eloquence
•	spazio su disco sufficiente a contenere i file MP3 generati
•	una scheda audio.
4. Installazione
Il programma viene fornito in due versioni:
•	il pacchetto installabile, distribuito col file testimp3-xxxx.zip 
•	il pacchetto portabile, distribuito col file testimp3-xxxx-portabile.zip
Nota: per entrambi i pacchetti xxxx indica il numero di versione del programma.
4.1 Versione installabile
Per installare il programma occorre:
1)	decomprimere in una cartella temporanea il file TestiMP3-xxxx.zip
2)	avviare dalla cartella creata al punto 1 il file Setup.exe (nota: affinché vengano create le voci del menu contestuale per la conversione di file di testo in Esplora Risorse è necessario eseguire il programma con privilegi di amministratore)
3)	seguire le istruzioni fornite dal setup fino al completamento dell’installazione
Durante l’installazione, attivando uno degli appositi checkbox, è possibile specificare se per default si preferisce che i file audio vengano creati come singoli file o che vengano convertiti in audio book e importati in iTunes.
La procedura di installazione copia nella cartella scelta dall’utente i file necessari all’esecuzione del programma e crea le seguenti icone nel gruppo di programmi TestiMP3:
•	Avvio comandi: permette l’avvio del prompt dei comandi posizionato nella cartella di installazione del programma
•	Documentazione: apre questo manuale
•	Configurazione: apre con il Notepad di Windows il file di configurazione (vedi par. 6)
•	Disinstallazione: rimuove il programma dal computer
•	Sito del programma: apre il browser e visualizza la homepage del sito di TestiMP3
Oltre alla creazione delle icone, il programma di installazione aggiunge la voce Converti con TestiMP3 al menu contestuale di Esplora risorse collegato ai file di testo .TXT (nota: solo se l’installazione è stata effettuata con privilegi di amministratore).
4.2 Versione portabile
Per installare la versione portabile è sufficiente scompattare il pacchetto di installazione in una cartella di gradimento dell’utente. Non vengono create né icone né voci nel menu di avvio. E’ possibile usare il programma anche da un dispositivo USB a patto che sul computer dove lo si andrà ad eseguire sia presente la sintesi vocale richiesta.
5. Uso del programma
5.1 Avvio rapido da Esplora risorse
TestiMP3 è un programma a riga comandi, cioè viene eseguito nel prompt dei comandi di Windows e non possiede una propria interfaccia a finestre. Tuttavia, con la versione 1.06f è stata introdotta una modalità ad avvio rapido che non necessita la digitazione di comandi per convertire un singolo file di testo senza apportare modifiche alla configurazione impostata dall’utente. Per convertire un testo in modo rapido occorre:
1)	aprire Esplora risorse
2)	navigare fino al file di testo che si vuole convertire
3)	attivare il menu di contesto relativo al file prescelto cliccando di destro con il mouse o premendo il tasto Maiusc+F10
4)	scorrere alla voce del menu Converti con TestiMP3 e premere Invio
5)	il processo di conversione si avvia
Durante l’esecuzione il programma avvisa l’utente di eventuali errori e della fine del processo con apposite finestre di dialogo; inoltre il programma modifica il titolo della finestra dei comandi, indicando la percentuale, il tempo previsto per il completamento e il file correntemente processato; è quindi possibile conoscere lo stato di avanzamento dall'ambiente grafico, controllando il titolo della finestra nella barra delle applicazioni. E’ comunque possibile selezionare quella finestra ed attivarla per entrare nel prompt dei comandi che sta eseguendo TestiMP3 per interrompere l’esecuzione o per controllare il processo (vedi dopo).
Alla fine del processo nella cartella contenente il file di testo: 
a)	se si è richiesto di frammentare il file (vedi paragrafo 6), verrà creata una  cartella che ha per nome lo stesso nome del file privo di ogni estensione, all'interno della quale vengono salvati i blocchi di dimensione prefissata in cui viene suddiviso il testo in singoli file MP3. Questi sono nominati numerandoli a partire da 001 (3 cifre) a seguire fino al completamento dell'intero file di testo. Per esempio, se convertiamo il file Pippo.txt, verrà creata una cartella di nome Pippo, all'interno della quale troveremo i file 001.mp3, 002.mp3, 003.mp3, 004.mp3 eccetera.
b)	se si è richiesto di creare un singolo file audio (vedi paragrafo 6), verrà generato un file che ha per nome lo stesso nome del file con estensione MP3. Per esempio, se convertiamo il file Pippo.txt senza frammentazione, verrà creato un file di nome Pippo.mp3.
Nota: se nel file di configurazione è stato impostato un percorso per i file di destinazione, la cartella o il file generati si troveranno sotto quella.
5.2 Avvio da riga comandi
Dal menu Avvio, sottomenu Programmi, cartella TestiMP3, selezionando la voce Avvio comandi, si apre la finestra col classico cursore che attende che si digiti un comando. 
Per convertire un file senza modificare le opzioni di default o quelle impostate nel file TestiMP3.ini basta digitare il comando testimp3 seguito dal nome del file di testo: esempio: testimp3 Pippo.txt. Se nel nome del file compaiono degli spazi, occorre racchiuderlo tra doppi apici (esempio: testimp3 "Il libro della jungla.txt"). L'estensione .txt può essere omessa.
Per ogni file che viene convertito:
a)	se si è richiesto di frammentare il file (vedi paragrafo 6) il programma crea una cartella che ha per nome lo stesso nome del file privo di ogni estensione, all'interno della quale vengono salvati i blocchi di dimensione prefissata in cui viene suddiviso il testo in singoli file MP3. Questi sono nominati numerandoli a partire da 001 (3 zeri) a seguire fino al completamento dell'intero file di testo. Per esempio, se convertiamo il file Pippo.txt, verrà creata una cartella di nome Pippo, all'interno della quale troveremo i file 001.mp3, 002.mp3, 003.mp3, 004.mp3 eccetera
b)	se si è richiesto di creare un singolo file audio (vedi paragrafo 6), il programma genera un file che ha per nome lo stesso nome del file con estensione MP3. Per esempio, se convertiamo il file Pippo.txt senza frammentazione, verrà creato un file di nome Pippo.mp3.
È possibile specificare più di un file da processare inserendo più nomi di file sulla riga di comandi: esempio testimp3 Pippo.txt Pluto.txt. Sono altresì ammessi i caratteri jolly * e ?, esempio testimp3 *.txt converte tutti i file txt nella cartella corrente.
È anche possibile creare delle liste di testi, inserendo i nomi, uno per riga, in un apposito file. La sintassi del comando per processare una lista di file consiste nel far precedere il carattere @ al nome del file di lista nella riga di comando: esempio testimp3 @mieifile.lst. Se i nomi di file che vengono inseriti in una lista contengono spazi, non è necessario racchiuderli tra doppi apici.
Durante l'esecuzione, a seconda del livello di verbosità impostato, verranno visualizzati i nomi dei file di testo processati e i file MP3 creati, nonché il tempo trascorso dall'inizio del processo, la percentuale di dati processati e il tempo stimato per il completamento. Il programma modifica anche il titolo della finestra dei comandi, indicando la percentuale, il tempo previsto per il completamento e il file correntemente processato; è quindi possibile conoscere lo stato di avanzamento anche dall'ambiente grafico, controllando il titolo della finestra nella barra delle applicazioni.
Sarà sempre possibile interrompere il processo premendo i tasti Control Pausa oppure Control C.
6. Configurazione del programma
È possibile impostare molti dei parametri di conversione sia attraverso la formulazione del comando che selezionando dei valori di default nel file di configurazione. 
Le opzioni sulla riga di comando vanno poste prima dei nomi di file da processare. Le opzioni hanno lo stesso nome sia per la riga comandi che per il file di configurazione, salvo che nel primo caso al nome dell'opzione va anteposto il carattere / che nel file di configurazione è facoltativo.
È possibile provare l'effetto delle impostazioni senza generare file audio inserendo nella riga comandi l'opzione /TEST (Esempio: testimp3 /VO=50 /V=5 /TEST Pippo.txt). Anche in questo caso il processo viene interrotto premendo Control-Pausa o Control-C.
Nota: per effettuare il test su un computer con scheda audio monocanale su cui si sta utilizzando lo screen reader Jaws con sintesi vocale Eloquence occorre disattivarlo temporaneamente.
6.1 Impostazione dell'engine di sintesi vocale
Per poter funzionare, il programma deve conoscere la posizione dei file necessari per la sintesi vocale. Se sul sistema è installata una versione di Jaws dalla 3.5 in poi, il programma dovrebbe identificarla automaticamente. Ma se sul computer non è installato Jaws, se si vuole utilizzare una sintesi diversa da quella dello screen reader o l'impostazione automatica non avviene, occorre farlo manualmente. Il formato del comando da digitare dopo aver selezionato l’icona Avvio comandi dalla cartella TestiMP3 del menu Programmi è:
testimp3 /ECISETUP=cartella
oppure
testimp3 /ECISETUP=percorso
cartella è la cartella sul disco fisso dove è contenuto il file Eci.dll; percorso è l'intero nome del file da utilizzare per la sintesi vocale. Esempi:
testimp3 /ECISETUP=C:\Jaws620
testimp3 /ECISETUP=C:\Programmi\Viavoice\IbmEci.dll
6.2 Il file di configurazione
La configurazione del programma è mantenuta nel file TestiMP3.ini, locato nella cartella di installazione del programma. Lo si può richiamare dal menu Avvio, sottomenu Programmi, cartella TestiMP3, icona Configurazione. 
La modifica può essere effettuata con il NOTEPAD o qualunque altro editor di testi. Prima di modificarlo è auspicabile farne una copia di backup.
Le opzioni sono espresse con la formula nomeparametro=valore. Il file è suddiviso in varie sezioni le quali iniziano con una etichetta di testo circondata dai segni [ ] (aperta parentesi quadra e chiusa parentesi quadra. La sezione [TestiMP3] viene automaticamente caricata all’avvio del programma, prima della scansione della riga di comando.
Le altre sezioni sono opzionali e possono essere utilizzate per creare particolari situazioni di configurazione. Ad esempio, se si vuole creare un particolare profilo per convertire i file in lingua inglese impostando una velocità diversa da quella per l’italiano, si può creare una sezione così:
[Inglese]
Lingua=UK
Velocita=120
Per fare in modo che il programma carichi anche i parametri definiti nella sezione dell’utente, in riga comandi occorrerà digitare:
TestiMP3 /CONFIG=Inglese testoininglese.txt
6.3 Parametri per il trattamento del testo
/TIPOTESTO=tipotesto oppure /TT=tipotesto
Indica se i testi da processare sono in formato MSDOS o Windows. I valori ammessi sono AUTO, DOS, WINDOWS o UTF8, abbreviabili in A, D, W e U. Se si indica AUTO, il programma tenta di determinare automaticamente il formato del testo. Il valore di default è AUTO.
Nota: se si seleziona AUTO, il programma prima verifica se il testo è a codifica UTF-8, dopodiché ricerca la presenza delle lettere accentate della lingua italiana e, a seconda dei codici ASCII che esse hanno, viene selezionato il tipo del testo; se l'impostazione automatica dovesse causare problemi nella corretta dicitura delle lettere accentate occorre impostare manualmente il valore.
/ELIMINANUMERIPAGINA=siono oppure /EN=siono
Specifica se eliminare dal flusso di conversione le righe che contengono un numero. Se la riga precedente quella col numero termina con una parola con trattino, viene anche effettuata la fusione con quella successiva. I valori ammessi sono SI o NO, abbreviabili con S o N, quello di default è NO.
6.4 Parametri per le cartelle, i frammenti e il raggruppamento
/DESTINAZIONE=cartella oppure /D=cartella
Specifica la cartella sotto cui verranno creati i file MP3 non frammentati o le  sottocartelle dove vengono registrati i file MP3; per default queste cartelle vengono create nella stessa cartella da cui viene lanciato il programma.
/FRAMMENTI=NO o numero oppure /F=NO o numero
Se impostato a NO, viene creato un unico file. Un numero invece imposta la dimensione in kilobyte dei singoli blocchi in cui viene suddiviso il file di testo; i valori ammessi vanno da 4 a 128; quello di default è 16.
Nota1: Lasciando impostati i valori di default un blocco di 16k di testo viene convertito in un file MP3 di circa 5,5 Megabyte della durata di circa 14 minuti.
Nota2: se si richiede la conversione in formato M4B o l’importazione in iTunes il parametro è ignorato eviene creato un file unico
/GRUPPI=NO o numero oppure /G=NO o numero
Specifica se stabilire un numero massimo di file MP3 per cartella. Valori ammessi sono NO o un numero tra 5 e 50. Se il numero di file generati supera il numero specificato, il programma li raggruppa in diverse cartelle che, in dipendenza dell'opzione RIUNISCIGRUPPI, avranno come nome lo stesso nome del testo senza estensioni seguito da un progressivo a due cifre (esempio PIPPO01, PIPPO02) oppure saranno riunite in una cartella padre col nome del testo ed avranno ciascuna un progressivo a due cifre (esempio: PIPPO\01, PIPPO\02); ciascuna cartella conterrà al massimo il numero di file specificato nel parametro. Il valore di default è NO.
Nota: l’opzione ha effetto solo se si è richiesta la frammentazione del file generato.
/RIUNISCIGRUPPI=siono oppure /RG=siono
Specifica se le cartelle dei gruppi debbano essere riunite in una cartella padre o debbano stare allo stesso livello. Può avere valore SI o NO, quello di default è NO.
Nota: l’opzione ha effetto solo se si è richiesta la frammentazione del file generato.
/CARTELLEROCKBOX=siono oppure /CR=siono
Specifica se creare in ciascuna cartella il file _dirname.talk utilizzato dal programma di gestione Rockbox dei riproduttori Archos per vocalizzare il nome della stessa. I valori ammessi sono SI o NO, abbreviabili con S o N, quello di default è NO.
Nota1: I file generati sono supportati da Rockbox versione 3.0 o superiori.
Nota2: l’opzione ha effetto solo se si è richiesta la frammentazione del file generato.
/IDENTIFICACARTELLA=siono oppure /IC=siono
Specifica se inserire in ogni cartella un file che ne vocalizza il contenuto. Simile all'opzione /CARTELLAROCKBOX, utile per tutti gli altri lettori MP3. I valori ammessi sono SI o NO, abbreviabili con S o N, quello di default è SI.
Nota1: il file indice si chiama 000.mp3.
Nota2: l’opzione ha effetto solo se si è richiesta la frammentazione del file generato.
/RIGAFRAMMENTA=testo o /RF=testo
Permette di definire la stringa che causerà la chiusura di un frammento nel punto in cui desidera l'utente. In quel punto del testo l'utente dovrà inserire la stringa qui indicata in una riga che contenga solo questa. Il valore di default è nulla, che vuol dire che il programma frammenta solo secondo il limite impostato con /FRAMMENTI.
Nota1: Per evitare la frammentazione automatica e utilizzare solo quella desiderata, impostare /FRAMMENTI al suo valore massimo e inserire nel testo righe che causino la frammentazione.
Nota2: l’opzione ha effetto solo se si è richiesta la frammentazione del file generato.
/NOMEFILE=testo oppure /NF=testo
Specifica una stringa da anteporre al nome dei file MP3 generati. Per esempio se si specifica /NOMEFILE=FILE, i frammenti avranno i nomi FILE001.MP3, FILE002.MP3 e così via. Il valore di default è nulla.
Nota: l’opzione ha effetto solo se si è richiesta la frammentazione del file generato.
/TITOLO=siono oppure /TI=siono
Specifica se impostare un titolo vocalizzato all'inizio di ogni file audio. Il titolo viene composto col nome del file esclusa l'estensione e il progressivo del blocco; la titolazione è molto utile per ritrovare il segno se il supporto (CDROM o altro) su cui vengono registrati i file ne contiene molti. I valori ammessi sono Si e NO, abbreviabili con S o N, quello di default è Si.
6.5 Parametri per la sintesi vocale
/LINGUA=idlingua oppure /L=idlingua
Specifica la lingua dei testi che si vuole processare. I valori ammessi sono IT per l'italiano, UK per l'inglese, FR per il francese, SP per lo spagnolo, DE per il tedesco, PB per il portoghese/brasiliano, US per l'americano. Il valore di default è IT (italiano).
/VOCE=numero oppure /V=numero
Specifica quale voce del sintetizzatore deve essere utilizzata. I valori ammessi sono da 0 a 8, ma il tipo di voce è determinato dall'engine TTS utilizzato. La voce 0 è quella standard, ed è anche il valore di default.
/VELOCITA=numero oppure /VE=numero
Specifica la velocità della sintesi in numero di parole medie al minuto. Il valore ammesso un numero compreso tra 70 e 1297; è anche possibile usare il valore predefinito dell'engine di sintesi vocale specificando il carattere * al posto del numero; il valore di default comunque è 200.
Nota: Malgrado lo standard ECI sia in grado di produrre velocità stratosferiche, la mente umana non riesce a capire nulla se questa è impostata a valori troppo alti. Il consiglio è di non andare al di sopra di 350 parole al minuto.
/TONALITA=numero oppure /TO=numero
Specifica la tonalità media della voce espressa in Hertz. Il valore ammesso è un numero compreso tra 40 e 422; è anche possibile usare il valore predefinito dall'engine di sintesi vocale specificando il carattere * al posto del numero; il valore di default è * (predefinito voce sintesi).
/VOLUME=numero oppure /VO=numero
Specifica il volume del parlato. Il valore ammesso è un numero compreso tra 1 e 100, è anche possibile usare il valore predefinito dall'engine di sintesi vocale specificando il carattere * al posto del numero; il valore di default comunque è 100.
/PAUSATESTA=n oppure /PT=n
Specifica la pausa di silenzio in millisecondi da inserire all'inizio di ogni frammento. I valori ammessi vanno da 0 a 5000, quello di default è 0.
/PAUSACODA=n oppure /PC=n
Specifica la pausa di silenzio in millisecondi da inserire alla fine di ogni frammento. I valori ammessi vanno da 0 a 5000, quello di default è 500.
Nota: si possono utilizzare i due parametri per inserire pause in testa o in coda se il lettore MP3 utilizzato non inizia dalla prima parola del testo o se vengono effettuati troncamenti in coda.
/SAMPLE=numero oppure /SA=numero
Specifica il sampling rate di uscita della sintesi, che influisce sulla qualità del parlato. I valori ammessi sono 8000 e 11025, abbreviabili con 8 e 11, quello di default, vivamente consigliato, è 11025.
6.6 Parametri per I file  MP3
/BITRATE=numero oppure /BR=numero
Specifica il rate di compressione MP3. Valori più bassi indicano una minore qualità ma anche dimensioni di file più ridotte. I valori ammessi sono 32, 48, 64, 96 e 128, quello di default è 48.
/ID3TAG=siono oppure /I3=siono
Permette di specificare se si vuole accodare le informazioni ID3 TAG V1.1 ai file MP3 generati. I valori ammessi sono SI e NO abbreviabili con S o N, quello di default è SI.
Nota1: alcuni lettori MP3 richiedono quest'informazione per ordinare il flusso dei frammenti; si consiglia di attivare l'opzione se il lettore legge i frammenti in ordine sparso. Le informazioni ID3 TAG occupano 128 byte per file.
Nota2: nel paragrafo 6.9 viene spiegato come impostare i valori di Artista, Album e Titolo.
/RESAMPLE=siono o n oppure /RS=siono o n
Permette di cambiare il sampling rate MP3. I valori ammessi sono:
•	NO (abbreviabile con N): specifica che il sampling rate MP3 sarà il medesimo di uscita della sintesi
•	SI (abbreviabile con S): specifica che il sampling rate deve essere compatibile con lo standard MPeg Layer 3 versione 1, e cioè 44100 Hz se la sintesi è stata prodotta a 11025 Hz e 32000 Hz se è stata prodotta a 8000 Hz
•	la frequenza in Hertz desiderata; i valori ammessi sono 8, 8000, 11, 11025, 16, 16000, 22, 22025, 24, 24000, 32, 32000, 44, 44100 e 48, 48000
•	Nel caso si imposti il resample a SI, la codifica viene effettuata internamente da TESTIMP3, mentre se si imposta un numero il compito viene delegato all'encoder MP3. Nel primo caso la velocità è maggiore, nel secondo migliora la qualità. L'impostazione di default è comunque NO.
Nota1: Se il lettore MP3 non legge i file prodotti da TESTIMP3, si consiglia di impostare il RESAMPLE a SI. Questa impostazione causa un rallentamento nella produzione dei file, ma garantisce una maggiore compatibilità con lettori non recenti.
Nota2: Alcune versioni di LAME_ENC.DLL non sembrano supportare tutti ipossibili valori di resample; ad esempio, specificando RESAMPLE=16000, la versione 3.93.1 fa crashare il programma. La versione 3.84 non mostra avere problemi di sorta.
6.7 Supporto ai dispositivi Apple
/FORMATOAUDIO=MP3 o M4B oppure /FA=MP3 o M4B
Specifica se generare file in formato MP3 (default) oppure in audio book per iPhone, iPod e iPad. La codifica avviene in un passo successivo alla conversione e richiede la presenza sul computer del programma iTunes per Windows.
Nota1: durante il processo di conversione in formato M4B, che può richiedere decine di minuti, TestiMp3 resta in attesa del completamento, e sarà possibile conoscere lo stato di avanzamento direttamente dal programma iTunes, che non andrà chiuso fino a quando non verrà data segnalazione di fine del processo
Nota2: la conversione in formato M4B opera solo su file non frammentati, quindi tutte le opzioni relative al raggruppamento e alle cartelle verranno ignorati.
/IMPORTAINITUNES=siono oppure /IT=siono
Impostando il valore a SI, i file creati (MP3 o M4B) vengono importati nella libreria di iTunes, in una apposita playlist chiamata TestiMP3. I tag Autore e Titolo vengono impostati secondo le modalità descritte nel paragrafo 6.9. TestiMP3 fa sì che iTunes imposti i flag per Ricorda la posizione di riproduzione ed Ignora quando casuale, ma la posizione dei file cambia a seconda del formato: libreria musicale per gli MP3 e Audiolibri per M4B. I file importati potranno essere trasferiti al dispositivo di lettura con una sincronizzazione di iTunes.
Nota: l’importazione in iTunes opera solo su file non frammentati, quindi tutte le opzioni relative al raggruppamento e alle cartelle verranno ignorati.
6.8 Altri parametri
/PRIORITA=valore oppure /P=valore
Specifica la priorità di esecuzione del programma. I valori ammessi sono BASSA e NORMALE, abbreviabili con 0 e 1, quello di default è BASSA, consigliato perché non rallenta l'utilizzo del PC durante la conversione dei file.
/VERBOSITA=numero oppure /VB=numero
Specifica la quantità di messaggi emessi dal programma. I valori ammessi sono 0 visualizzazione dei soli messaggi d'errore, 1 visualizzazione anche del nome del file di testo processato, 2 indicazione anche dei file MP3 in generazione, 3 visualizzazione anche dello stato d'avanzamento della generazione del blocco corrente (espresso in Kilobyte di dati prodotti dall'engine di sintesi vocale); il valore di default è 2.
Nota1: come per ogni programma a riga di comandi, è possibile reindirizzare i messaggi su un file di testo aggiungendo al comando il segno > seguito dal nome del file che riceverà i messaggi.
Nota2: i nomi dei file processati e generati vengono preceduti dall'orario di inizio, permettendo di controllare le performances del programma.
/CONFERMACANCELLA=siono oppure /CC=siono
Specifica se si desidera che TestiMp3 cancelli automaticamente i file MP3 creati da una precedente conversione dello stesso file fatta nella stessa cartella. Il valore di default è Si.
Nota: nel caso il programma trova file precedentemente generati nella cartella indicata, se l'opzione è attiva, chiederà di digitare Si o No in risposta alla domanda. Se l'utente risponde di no, il processo verrà interrotto.
Nota: l’opzione ha effetto solo se si è richiesta la frammentazione del file generato.
/AVVISIFINESTRA=siono oppure /AF=siono
Specifica se inviare i messaggi di errore, di fine processo e la richiesta di conferma di cancellazione all'ambiente grafico invece che alla finestra a caratteri. Questo permette durante la conversione di continuare a lavorare nell'ambiente grafico senza dover controllare continuamente lo stato di esecuzione del programma. Il default è NO.
Nota: I messaggi verranno visualizzati in una finestra di dialogo e saranno accompagnati da un segnale acustico.
/MINIMIZZAFINESTRA=siono oppure /MF=siono
Causa la minimizzazione automatica della finestra dei comandi dopo l’avvio. I valori ammessi sono SI o NO, abbreviabili con S o N, quello di default è NO.
Nota: l’opzione non ha effetto su sistemi operativi Windows 9x, Me ed NT.
/ECIDLL=libreria
Indica il percorso della DLL della sintesi vocale. Il valore di default è ECI.DLL, che presuppone che questo file debba trovarsi nella stessa cartella di avvio del programma o nelle cartelle di sistema.
/MP3DLL=libreria
Indica il percorso della DLL dell'encoder MP3. Il valore di default è LAME_ENC.DLL, che è la libreria fornita col pacchetto.
/RBSPEEXENC=comando
Specifica il comando per la creazione delle etichette di cartella Rockbox. Il default è
Bspeexenc.exe -q 10 "%1" "%2"
%1 indica il file di origine (file temporaneo); %2 indica il file destinazione (_dirname.talk)
6.9 Impostazioni di autore, titolo e nome file creato
Sia per i tag ID3 sia per gli audio book importati in iTunes, TestiMP3 offre delle opzioni per impostare i valori di Autore e Titolo.
Per default, il campo Artista è settato al valore “TestiMP3”, il campo Album (per i file non frammentati anche il Titolo) al nome del file ad esclusione dell’estensione. 
Nota: per i tag ID3 i valori non possono superare i 30 caratteri e il programma li tronca. 
E’ possibile modificare i valori in due modi:
1)	inserendo nel testo come prima riga una stringa così composta: #info Autore::Titolo (Autore e Titolo sono separati da un doppio due punti). La riga viene ignorata se le opzioni /ID3TAG e /IMPORTAINITUNES sono impostata a NO e non viene selezionata la conversione in formato M4B.
2)	Accodando al nome del file di testo, sia passato come parametro in riga comandi, sia inserito in un file di lista di testi da convertire, le info aggiuntive; queste sono composte da una lettera che specifica il tipo di informazione, dal segno = (uguale) e dal valore associato; le opzioni e il nome del file vanno separate con la sequenza :: (due volte due punti). Le info impostabili sono: A=autore::T=titolo::D=destinazione (la destinazione è il nome che si vuole fare assumere al file creato). Esempio
TestiMp3 “promessi.txt::A=Alessandro Manzoni::T:I Promessi Sposi::D=Promessi Sposi”
Nota: se il nome del file è passato sulla riga comandi e sono contenuti degli spazi, tutta la sequenza va racchiusa tra “ (virgolette).
7. Problemi di riproduzione
Se con le impostazioni standard i file MP3 non vengono riprodotti dal lettore che utilizzate, fate queste prove:
•	inserite pause in testa e/o in coda (/PAUSATESTA=n e/o /PAUSACODA=n) se si verificano troncamenti
•	forzate il resampling (/RESAMPLE=SI oppure /RESAMPLE=44) per produrre file MP3 versione 1
•	impostate la generazione degli ID3 Tag (/ID3TAG=Si)
•	aumentate il bitrate progressivamente; aumenteranno le dimensioni dei file ma anche la compatibilità
8. Revisioni
12/04/2011
Bugfix: risolto problema generazione multipla di file di testo di diverso formato
11/04/2011 1.08f
Miglioria: Anche per i file non frammentati viene impostato il valore di Album nei tag
09/04/2011 1.08b4
Bugfix: risolto un problema nell’importazione in iTunes di file non convertiti in formato AAC
20/03/2011 1.08b3
Novità: separazione della funzione di importazione in iTunes e conversione in formato M4B
Migliorie: generazione di etichette per le cartelle Rockbox compatibile con la versione 3.0 o superiore del firmware; le versioni precedenti non sono più supportate
Bugfix: risolto un problema nella generazione di più file con la stessa chiamata del comando
13/03/2011 1.08b2
Novità: conversione dei file in formato audio book e importazione in iTunes
Novità: durante il setup è possibile scegliere come default la conversione in audio book e importazione in iTunes
Novità: configurazioni aggiuntive richiamabili da riga comandi
Novità: impostazione di autore, titolo e destinazione da riga comando o lista di file
07/03/2011 1.07f
Bugfix: risolto problema calcolo percentuale di avanzamento per file multipli
06/03/2011 1.07f
Novità: aggiunta la possibilità di generare un singolo file mp3 da ciascun file di testo
Novità: aggiunto supporto al formato testo a codifica UTF-8
Novità: aggiunta opzione per eliminare i numeri di pagina
Novità: aggiunta la possibilità di impostare autore e titolo nei tag ID3 dal file di testo
Migliorie: in sede di reinstallazione è possibile conservare le impostazioni di default 
Migliorie: in sede di installazione è possibile selezionare come default la generazione di file audio non frammentati
Rimozioni: eliminata la possibilità di riprendere un lavoro interrotto
01/08/2008 1.06f
Novità: procedura di installazione
Novità: avvio del programma da Esplora risorse
Novità: aggiunta opzione MINIMIZZAFINESTRA
Migliorie: manuale rivisto e fornito in rtf
23/02/2008 1.05b
Novità: ora viene riconosciuta in automatico la sintesi Eloquence in dotazione alle versioni 7.x e 8.x di Jaws (non testata con Jaws 9)
Novità: inserita la generazione di indici di cartella anche per lettori non compatibili con Rockbox
Novità: si possono usare i caratteri jolly * e ? per specificare i nomi di file da processare
04/04/2005 1.04f
Novità: introdotto il supporto ai nomi delle cartelle per Archos con firmware Rockbox
Novità: introdotto il raggruppamento delle cartelle.
13/05/2003 1.03f
Bug fix: risolto il problema di troncamento file contenenti caratteri ASCII 0.
25/04/2003 1.02f
Dopo due mesi si esce con una nuova versione pubblica con piccoli miglioramenti.
Novità: Introdotta la stima del tempo di completamento del processo
Migliorie: Migliorato l'algoritmo di gestione delle punteggiature
Bug fix: Risolto il problema di buffer sporco se il riconoscimento del set di caratteri automatico è dubbio.
14/02/2003 1.01b
Migliorie: il parametro bitrate può anche assumere i valori 16 e 32
08/02/2003 1.00f
Ce l'abbiamo fatta! Questa è la prima versione pubblica, verrà messa a disposizione sul sito http://utenti.lycos.it/testimp3/.
Migliorie: aggiunta la sezione Riproduttori MP3 al manuale.
05/02/2003 0.95b
Bug fix: corretto l'errore nel riconoscimento del parametro ID3TAG.
05/02/2003 0.94b
Prima release candidate, da ora fino alla versione 1.00 non verranno aggiunte nuove funzionalità.
Novità: Implementata la possibilità di raggruppare in cartelle i file MP3 prodotti
Novità: Implementata la generazione degli ID Tag V1.1 per la compatibiltà con alcuni lettori MP3
Novità: I nomi dei frammenti ora cominciano da 001.mp3
Novità: È ora possibile anteporre un prefisso ai nomi dei file creati dal programma;
Novità: Impostazione automatica della libreria della sintesi vocale se nel sistema è installato Jaws 3.5 o successive
Miglioria: migliorato l'algoritmo di frammentazione automatica dei file
Miglioria: migliorato il meccanismo di determinazione del tipo di file di testo
Bug fix: corretto il meccanismo di gestione della ripresa del lavoro.
02/02/2003 0.93b
Novità: Supporto per l'MPEG Layer 3 Versione 1 e il settaggio del resampling da parte dell'utente
Novità: Possibilità di riprendere il lavoro interrotto
Novità: Possibilità di inserire pause a inizio e fine frammento
Miglioria: messaggi diagnostici più chiari.
29/01/2003 0.92b
Novità: incremento notevole delle prestazioni
Novità: introdotta la selezione della voce al posto di quella del genere
Novità: possibilità di testare la voce coi parametri impostati
Novità: introdotta la richiesta di cancellazione dei file esistenti
Novità: possibilità di inviare i messaggi critici all'ambiente a finestre;
Novità: segmentazione dei testi definita dall'utente
Bug fix: fissato il problema di perdita di dati in certi casi particolari;
28/01/2003 0.91b
Novità: Inserito il controllo automatico del tipo di file di testo (/TIPOTESTO=AUTO)
Novità: si possono utilizzare le ultime versioni dell'encoder Lame; il programma ora viene distribuito col LAME_ENC.DLL 3.93.1
Novità: Eliminato il parametro QUALITA che risultava inutile e confusivo
Bug fix: fissato il problema del default del volume
Bug fix: il parametro MP3DLL ora funziona correttamente
Bug fix: if default di /DESTINAZIONE è ora corretto.
25/01/2003 - 0.90b
Rilascio della prima beta con distribuzione per posta elettronica.
9. Ringraziamenti
Ringrazio innanzitutto il gruppo di test, composto da 30 persone che mi hanno aiutato a scovare i molti errori che avevo disseminato nel programma.
Consigli preziosi mi hanno dato Dante Balbo alias gandalfdb, Alessio Lenzi e Arturo Tomaselli.
Voglio poi ringraziare Giuseppe Di Grande (http://www.digrande.it) col quale abbiamo concepito l'idea e che ha sviluppato Biblos e distribuisce (http://www.digrande.it/biblos/), un programma  finestre che fa anche i bambini, mentre io preferisco ancora i metodi tradizionali e la riga di comando.