Andare al contenuto principale
SubtitleMatrix

Convertire JSON in CSV

Oppure incollare il testo dei sottotitoli

Cosa cambia questa conversione

3 elementi vengono scartati o richiedono una decisione

  • Stile

    tutto lo stile (grassetto, corsivo, colore, contorno, ombra)

  • Posizionamento

    il posizionamento sullo schermo (ogni blocco torna alla posizione predefinita)

  • Karaoke

    la temporizzazione karaoke (evidenziazione per sillaba)

Questo elenco deriva dalla matrice delle capacità di questi due formati, non dal particolare file caricato. Un file specifico può perdere di più se usa caratteristiche che il formato consente ma la matrice non modella.

Questa pagina converte un file JSON in CSV. Si trascina il file nel riquadro, oppure si incolla il testo, e si riprende indietro la versione CSV. La conversione avviene interamente nel browser: nessun file viene caricato e non serve un account.

I due formati non conservano le stesse cose, e la differenza non è cosmetica: stile, posizione e karaoke non hanno dove stare in CSV. L’elenco qui sopra nasce da ciò che ciascuno dei due formati sa esprimere, non dal file che si carica, quindi la risposta è la stessa prima ancora di aprire qualcosa.

Un file va bene, e così un’intera stagione: la coda li lavora in ordine e i risultati scendono insieme in un unico ZIP.

Esempi

Un file JSON tipico, convertito in CSV

Ingresso

{
  "version": 1,
  "title": "Fixture: typical",
  "fps": 25,
  "styles": {
    "Default": {
      "name": "Default",
      "fontFamily": "Arial",
      "fontSize": 20,
      "primaryColor": "#FFFFFF",
      "bold": false,
      "italic": false
    }
  },
  "generator": "subtitlematrix fixtures",
  "cues": [
    {
      "id": "1",
      "start": 0,
      "end": 2000,
      "lines": [
        "Hello world.",
        "Second line."
      ],
      "style": "Default",
      "position": {
        "x": 100,
        "y": 200,
        "align": "center"
      }
    },
    {
      "id": "2",
      "start": 2500,
      "end": 4000,
      "lines": [
        "Plain line.",
        {
          "text": "Styled line.",
          "tags": [
            {
              "kind": "italic",
              "start": 0,
              "end": 6
            }
          ]
        }
      ]
    },
    {
      "id": "3",
      "start": 4500,
      "end": 6000,
      "lines": [
        "Roger: I am here."
      ],
      "speaker": "Roger"
    }
  ]
}

Uscita

start,end,text
00:00:00.000,00:00:02.000,"Hello world.
Second line."
00:00:02.500,00:00:04.000,"Plain line.
<i>Styled</i> line."
00:00:04.500,00:00:06.000,Roger: I am here.

In questa conversione si perdono: stile, posizione e karaoke. Tutto il resto corrisponde riga per riga.

La stessa conversione su un input scomodo

Ingresso

[
    { "start": 0, "end": 1000, "lines": ["First."] },
    { "start": 1000, "end": 2000, "text": "Second." },
    "not an object",
    { "start": 2000, "end": 3000, "lines": ["Third."], "class": "top" }
]

Uscita

start,end,text
00:00:00.000,00:00:01.000,First.
00:00:01.000,00:00:02.000,Second.
00:00:02.000,00:00:03.000,Third.

È il tipo di danno che hanno i file reali: fine riga misti, spazi vaganti, campi lasciati vuoti. Confronto con l’esempio ordinato qui sopra per vedere cosa il parser perdona.

Domande frequenti

Grassetto e corsivo sopravvivono dal JSON al CSV?

L’enfasi sì, la tabella degli stili no. La formattazione che appartiene a un pezzo di testo — grassetto, corsivo, sottolineato, un colore — viene scritta dentro il testo CSV come tag (`<i>`, `<b>`, `<u>`, `<font color="…">`), perché è l’unico tipo di stile che un formato per blocchi sa ancora portare. Si perde tutto quello che il file JSON diceva in generale: il carattere, la sua dimensione, il contorno, l’ombra e i margini.

Che fine fa la posizione sullo schermo passando da JSON a CSV?

CSV non sa dire dove viene disegnato un sottotitolo, quindi la posizione conservata con ogni blocco viene persa all’uscita dal JSON, e ogni blocco torna alla posizione predefinita scelta dal lettore: il fondo del fotogramma, centrato, per la maggior parte di essi.

Che fine fa il karaoke passando da JSON a CSV?

La temporizzazione se ne va, le parole restano. Il karaoke vive nelle campiture di karaoke che un blocco JSON porta con sé, che segnano quando ogni sillaba si accende, e CSV non ha modo di registrare un istante dentro una riga: i segni cadono e le sillabe arrivano come testo CSV normale.

Che aspetto ha il risultato quando JSON diventa CSV?

Come CSV: una riga di intestazione (`start,end,text`) e poi una riga per blocco. Ogni blocco JSON diventa un blocco CSV, nello stesso ordine, con lo stesso testo.

I tempi JSON sono esatti nel file CSV?

Sì, al millisecondo, che è la precisione massima di entrambi i formati. JSON scrive un istante come `4126` e CSV scrive lo stesso istante come `00:00:04.126`: fra i due non si arrotonda e non si sposta niente, e un blocco rimasto sullo schermo per 2,9 secondi lo resta.

Come esce in CSV un blocco JSON su due righe?

Come due righe dentro l’unica cella di testo, fra virgolette come richiede il CSV. L’abbinamento sopravvive: le due righe JSON restano un solo sottotitolo nel file CSV e il lettore le mostra insieme.

I blocchi JSON mantengono l’ordine nel file CSV?

Sì, e lungo la strada vengono ordinati per istante di inizio: prima il più anticipato, che è l’ordine atteso da ogni formato di questo sito e quello con cui i lettori li scorrono. Se il file JSON elencava i blocchi fuori sequenza, il CSV li rimette in ordine: è un intervento sulla struttura del file, non sul contenuto, ed è voluto.

Posso riconvertire il CSV in JSON?

Sì, e quella direzione non costa nulla: un file CSV contiene meno di quanto JSON sappia contenere, quindi al ritorno non si perde altro. Quello che questa direzione ha perso resta perso, però: stile, posizione e karaoke non si possono ricostruire da un file CSV, perché dentro non c’è nulla che li registri.

Il file CSV conserva la codifica del file JSON?

No: l’uscita è UTF-8, con fine riga Unix e senza BOM, qualunque codifica usasse il JSON. Un file che arriva in UTF-16 o in una codifica a byte singolo di Windows viene decodificato in ingresso (il pannello del risultato lo segnala quando accade); quello che esce è sempre lo stesso CSV in UTF-8.

Strumenti correlati