Converti TXT in VCARD

I telefoni e le applicazioni per la rubrica importano comunemente i contatti da file .vcf, non da elenchi in testo semplice. La conversione di un elenco di contatti TXT strutturato produce un file che può essere trasferito tra dispositivi, condiviso oppure importato nei software per email e contatti.

Cos'è il formato TXT

.txt è un formato di testo semplice non strutturato utilizzato da Notepad, TextEdit, strumenti del terminale, applicazioni meno recenti ed elenchi di contatti gestiti manualmente. Non dispone di campi di contatto o delimitatori standard.

Un elenco di contatti può contenere un contatto per riga, colonne separate da virgole o tabulazioni oppure etichette come Name:, Phone: ed Email:. Esamina il contenuto prima della conversione; la sola estensione non consente di identificare quale valore sia un cognome, un numero di telefono, un codice postale o una nota.

Cos'è il formato vCard

vCard è uno standard strutturato per i contatti, normalmente salvato con l'estensione .vcf. Può memorizzare un nome formattato, nome e cognome strutturati, numeri di telefono, indirizzi email, organizzazione, indirizzo postale, sito web, note e, a seconda della versione e dell'applicazione, anche una foto del contatto.

Un singolo file VCF può contenere uno o più contatti. vCard 3.0 è generalmente più compatibile con i telefoni meno recenti e le rubriche desktop; vCard 4.0 offre funzionalità più recenti, ma non è supportato da tutti gli strumenti di importazione. Android, iOS, Outlook, Thunderbird, Apple Contacts e Google Contacts supportano vCard, anche se la mappatura dei campi varia tra le applicazioni.

Convertire TXT con LibreOffice e Thunderbird

1. Apri il file TXT in LibreOffice Calc. Nella finestra di dialogo di importazione, seleziona Separated by e scegli il delimitatore effettivo, ad esempio Tab, la virgola o il punto e virgola. Verifica che ogni campo venga visualizzato nella colonna corretta.
2. Pulisci la tabella e usa una riga di intestazione con nomi non ambigui come First Name, Last Name, Mobile Number, Email e Organization. Salvala come contacts.csv tramite File → Save As.
3. Apri la rubrica di Thunderbird e scegli Tools → Import. Seleziona l'opzione di importazione della rubrica CSV o di testo, quindi associa ogni colonna di origine al campo appropriato di Thunderbird.
4. Esamina diversi record importati per verificare la presenza di nomi invertiti, zeri iniziali persi, tipi di telefono errati, caratteri accentati danneggiati e indirizzi email non validi.
5. Seleziona i contatti verificati e scegli Tools → Export. Salva il risultato come contacts.vcf; seleziona vCard 3.0 se Thunderbird offre la possibilità di scegliere una versione.

I nomi dei menu possono differire leggermente tra le versioni di Thunderbird. Se la procedura guidata di importazione non riconosce il file come CSV, salvalo prima da Calc come CSV separato da virgole con codifica UTF-8.

Usare uno script Python locale per dati separati da tabulazioni

Uno script è adatto quando il file TXT contiene una riga di intestazione denominata name, phone, email e, facoltativamente, organization, con un contatto per ogni riga separata da tabulazioni. Salva il file come txt_to_vcard.py:

import csv
import sys


def escape(value):
    value = str(value or '').replace('\\r\\n', '\\n').replace('\\r', '\\n')
    return value.replace('\\', '\\\\').replace(';', '\\;').replace(',', '\\,').replace('\\n', '\\n')


def fold(line):
    parts = []
    current = ''
    limit = 75
    for character in line:
        if len((current + character).encode('utf-8')) > limit:
            parts.append(current)
            current = ' ' + character
            limit = 74
        else:
            current += character
    parts.append(current)
    return '\\r\\n'.join(parts)


with open(sys.argv[1], encoding='utf-8-sig', newline='') as source, open('contacts.vcf', 'w', encoding='utf-8', newline='') as output:
    contacts = csv.DictReader(source, delimiter='\\t')
    for contact in contacts:
        full_name = (contact.get('name') or '').strip()
        name_parts = full_name.split()
        family = name_parts[-1] if name_parts else ''
        given = ' '.join(name_parts[:-1])
        lines = [
            'BEGIN:VCARD',
            'VERSION:3.0',
            'FN:' + escape(full_name),
            'N:' + escape(family) + ';' + escape(given) + ';;;'
        ]
        phone = escape(contact.get('phone', ''))
        email = escape(contact.get('email', ''))
        organization = escape(contact.get('organization', ''))
        if phone:
            lines.append('TEL;TYPE=CELL:' + phone)
        if email:
            lines.append('EMAIL:' + email)
        if organization:
            lines.append('ORG:' + organization)
        lines.extend(['END:VCARD'])
        output.write('\\r\\n'.join(fold(line) for line in lines) + '\\r\\n')

Eseguilo con python txt_to_vcard.py contacts.txt. Lo script crea contacts.vcf nella directory corrente. Il parser dei nomi considera l'ultima parola separata da spazi come cognome, quindi modifica questa logica per gestire cognomi composti, titoli, suffissi oppure colonne separate per nome e cognome.

Usare un convertitore online per dati non sensibili

Servizi online come CloudConvert o Online-Convert possono offrire la conversione da CSV a VCF, ma il supporto diretto per TXT e la mappatura dei campi variano. Se il servizio non accetta correttamente il delimitatore del TXT, apri il file in LibreOffice Calc, salvalo come CSV UTF-8 e converti quel CSV in VCF. Carica solo un piccolo campione anonimizzato o contatti non privati; un elenco di contatti contiene dati personali e potrebbe essere conservato dal servizio. Un flusso di lavoro locale con Thunderbird o uno script evita questa divulgazione.

Controlli di qualità e compatibilità

TXT non dispone di uno schema universale per i contatti, quindi la conversione automatica non può dedurre in modo affidabile il significato dei campi. Normalizza i numeri di telefono, conserva i prefissi internazionali e controlla i valori contenenti virgole, tabulazioni, punti e virgola, interruzioni di riga o zeri iniziali prima dell'esportazione.

Usa UTF-8 per conservare i nomi accentati. I valori testuali vCard richiedono l'escape per barre rovesciate, virgole, punti e virgola e interruzioni di riga; le righe generate devono inoltre essere suddivise quando superano il limite di lunghezza delle righe vCard. Verifica alcuni record prima di importare un file di grandi dimensioni, quindi controlla la presenza di contatti duplicati, campi troncati, foto non supportate e mappature errate dei nomi o dei tipi di telefono.