Importazione tracce CSV

PlayIt VoiceTrack può importare tracce da un file CSV (Comma-Separated Values) utilizzando la Procedura Guidata Aggiungi Nuove Tracce. Ciò è utile quando si migrano i metadati delle tracce da un altro sistema di playout, uno strumento di pianificazione musicale o un foglio di calcolo.

Prima di iniziare

L'importatore CSV si aspetta i dati in un formato specifico. Se si esporta da un altro sistema, quasi certamente sarà necessario convertire e riformattare i dati prima di poterli importare in PlayIt VoiceTrack. Ciò richiede un certo sforzo manuale e familiarità con strumenti per fogli di calcolo come Microsoft Excel o Google Sheets.

In particolare, tutti i valori di durata e di Cue Point devono essere in secondi decimali. I formati come 3:45 o 0:08.5 non sono accettati perché sono ambigui (potrebbero rappresentare minuti:secondi o ore:minuti). Sarà necessario convertire questi valori prima dell'importazione. Vedere Formati dei valori di seguito per i dettagli.

L'approccio migliore è esportare prima alcune tracce da PlayIt VoiceTrack utilizzando l'esportazione CSV in Gestisci Tracce. Ciò fornisce un modello con i nomi di colonna esatti e i formati dei valori che l'importatore si aspetta.

Creazione di un file CSV

Il file CSV deve avere una riga di intestazione con i nomi delle colonne, seguita da una riga per traccia. È possibile creare il file in qualsiasi applicazione per fogli di calcolo ed esportarlo come CSV, oppure scriverlo in un editor di testo.

Esempio minimo

Come minimo, ogni traccia necessita di un percorso file e di una durata:

Path,Artist,Title,Duration
C:\Music\Katrina and the Waves - Walking on Sunshine.mp3,Katrina and the Waves,Walking on Sunshine,239
C:\Music\Journey - Don't Stop Believin'.mp3,Journey,Don't Stop Believin',250.5
C:\Music\Queen - Bohemian Rhapsody.mp3,Queen,Bohemian Rhapsody,354

Esempio completo

Un file CSV più completo con colonne di temporizzazione e metadati:

Path,Artist,Title,Duration,Intro,Cue In,Cue Out,Genre,Year,Type
C:\Music\Walking on Sunshine.mp3,Katrina and the Waves,Walking on Sunshine,239,8.5,0,228,Pop,1985,Song
C:\Music\Bohemian Rhapsody.mp3,Queen,Bohemian Rhapsody,354,15,0,340,Rock,1975,Song

Formati dei valori

Ogni colonna ha un formato di valore specifico. L'utilizzo di un formato errato causerà il salto della riga durante l'importazione.

Secondi decimali

Tutte le colonne di durata e Cue Point devono essere in secondi decimali utilizzando un punto (.) come separatore decimale.

Corretto	Errato
`239`	`3:59`
`8.5`	`0:08.5`
`228.75`	`3:48.75`
`0`	`0:00`

Se i dati di origine utilizzano il formato minuti:secondi, sarà necessario convertirli. In un foglio di calcolo, è possibile utilizzare una formula come =MINUTE(A1)*60+SECOND(A1) per convertire un valore temporale nella cella A1 in secondi totali.

Testo

I valori di testo (Artist, Title, Album, ecc.) sono stringhe semplici. Se un valore contiene una virgola, l'intero valore deve essere racchiuso tra virgolette doppie nel file CSV. La maggior parte delle applicazioni per fogli di calcolo gestisce questo automaticamente durante l'esportazione in CSV.

Booleano

Le colonne booleane (No Fade, Sweeper, Disabled, Gain Set Manually?) accettano true o false (senza distinzione tra maiuscole e minuscole). Se la colonna è assente o vuota, il valore predefinito è false.

Data

Le colonne data (Valid From, Expires) accettano formati di data standard come 2026-01-15. La parte dell'orario viene ignorata.

Decimale

Le colonne decimali (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) utilizzano un punto (.) come separatore decimale. Ad esempio, -3.5 per una riduzione del guadagno di 3,5 dB.

Riferimento colonne

Colonne richieste

Solo le colonne Path e Duration sono necessarie per un'importazione valida. Tutte le altre colonne sono facoltative. Se una colonna è assente dall'intestazione, il campo viene lasciato vuoto o impostato al suo valore predefinito.

Colonna	Formato	Descrizione
Path	Testo	Il percorso completo del file audio su disco. Utilizzato per la riproduzione e il rilevamento dei duplicati.
Duration o Duration (seconds)	Secondi decimali	La durata totale della traccia (ad es. `239` o `228.5`).

Informazioni sulla traccia

Colonna	Formato	Descrizione
Artist	Testo	Il nome dell'artista o dell'esecutore.
Title	Testo	Il titolo della traccia.
Album	Testo	Il nome dell'album.
Genre	Testo	Il genere (ad es. Pop, Rock, Jazz).
Year	Testo	L'anno di pubblicazione.
Type	Testo	Il tipo di traccia. Deve essere uno degli identificatori di tipo elencati di seguito, oppure lasciato vuoto.
Tags	Testo	Tag separati da punto e virgola (ad es. `upbeat;classic;80s`).
Comments	Testo	Commenti in testo libero sulla traccia.
Out Cue	Testo	Il testo dell'out cue (ad es. "and don't it feel good!").
ISRC	Testo	L'International Standard Recording Code.
Record Label	Testo	Il nome dell'etichetta discografica.
Track ID	Testo	Un identificatore di traccia personalizzato.

Valori del tipo di traccia

La colonna Type deve utilizzare uno dei seguenti valori esattamente come mostrato di seguito.

Valore	Descrizione
`Song`	Una traccia musicale.
`Station ID`	Un jingle di identificazione della stazione.
`Promo`	Un annuncio promozionale.
`Commercial`	Uno spot commerciale o pubblicitario.
`News`	Un notiziario o clip di notizie.
`Bed`	Una base musicale di sottofondo.
`Station ID + Bed`	Un'identificazione di stazione combinata con una base musicale di sottofondo.

Se la colonna Type viene lasciata vuota, il tipo verrà dedotto automaticamente.

Cue Points e temporizzazione

Colonna	Formato	Predefinito	Descrizione
Intro	Secondi decimali	0	La durata dell'Intro. Il punto in cui iniziano le voci o il contenuto principale.
Cue In	Secondi decimali	0	Il punto Cue In. La riproduzione inizia da questo punto.
Cue Out	Secondi decimali	Uguale a Duration	Il punto Cue Out. La traccia è considerata terminata a questo punto.
Early Out	Secondi decimali	Non impostato	Il punto Early Out. Indica il punto in cui la traccia è quasi terminata.
Hook Start	Secondi decimali	Non impostato	L'inizio della sezione Hook della traccia. I Hook vengono utilizzati solo da PlayIt Live e vengono ignorati da PlayIt VoiceTrack.
Hook End	Secondi decimali	Non impostato	La fine della sezione Hook della traccia. I Hook vengono utilizzati solo da PlayIt Live e vengono ignorati da PlayIt VoiceTrack.

Controllo della riproduzione

Colonna	Formato	Predefinito	Descrizione
No Fade	Booleano	false	Impostare su `true` per disabilitare il Fade in uscita alla fine della traccia.
Sweeper	Booleano	false	Impostare su `true` per contrassegnare la traccia come Sweeper o jingle.
Disabled	Booleano	false	Impostare su `true` per impedire che la traccia venga programmata o riprodotta.
Valid From	Data	Non impostato	La data da cui la traccia diventa disponibile (ad es. `2026-01-15`).
Expires	Data	Non impostato	La data dopo la quale la traccia non è più disponibile.

Elaborazione audio

Colonna	Formato	Predefinito	Descrizione
Gain DB	Decimale	Non impostato	Regolazione del guadagno audio in decibel (ad es. `-3.5`).
Gain Set Manually?	Booleano	false	Impostare su `true` se il valore del guadagno è stato configurato manualmente anziché rilevato automaticamente.
Loudness Target LUFS	Decimale	Non impostato	Il target di normalizzazione del volume in LUFS.
Tempo Adjust Percentage	Decimale	Non impostato	Regolazione percentuale del tempo di riproduzione.

Gestione degli errori

Se una riga contiene un valore non valido (ad es. testo in una colonna numerica), quella riga viene saltata e l'errore viene registrato. Il resto dell'importazione continua.
Le colonne possono apparire in qualsiasi ordine nel file CSV.
Le colonne aggiuntive non riconosciute da PlayIt VoiceTrack vengono ignorate.
Se un valore contiene una virgola, racchiuderlo tra virgolette doppie (ad es. "Earth, Wind & Fire").