Importazione tracce da CSV
PlayIt Live può importare tracce da un file CSV (Comma-Separated Values) tramite l'Procedura Guidata Aggiungi Nuove Tracce. Questo è utile quando si migrano i metadati delle tracce da un altro sistema di playout, uno strumento di programmazione musicale o un foglio di calcolo.
Prima di iniziare
L'importatore CSV si aspetta 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 Live. 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 punti di cue 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 Live usando l'esportazione CSV in Gestisci Tracce. Questo fornisce un modello con i nomi esatti delle colonne e i formati dei valori attesi dall'importatore.
Creazione di un file CSV
Il file CSV deve avere una riga di intestazione con i nomi delle colonne, seguita da una riga per ogni traccia. È possibile creare il file in qualsiasi applicazione di foglio di calcolo ed esportarlo come CSV, oppure scriverlo in un editor di testo.
Esempio minimale
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,354Esempio 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,SongFormati dei valori
Ogni colonna ha un formato di valore specifico. L'utilizzo del formato errato causerà l'omissione della riga durante l'importazione.
Secondi decimali
Tutte le colonne di durata e punti di cue devono essere in secondi decimali usando 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 di tempo nella cella A1 in secondi totali.
Testo
I valori testuali (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 di foglio di calcolo gestisce questo automaticamente durante l'esportazione in CSV.
Booleano
Le colonne booleane (No Fade, Sweeper, Disabled, Ignore Validity Year?, 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 di data (Valid From, Expires) accettano formati di data standard come 2026-01-15. La parte dell'ora 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 obbligatorie
Solo le colonne Path e Duration sono necessarie per un'importazione valida. Tutte le altre colonne sono opzionali. 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 sul disco. Utilizzato per la riproduzione e il rilevamento dei duplicati. |
| Duration o Duration (seconds) | Secondi decimali | La durata totale della traccia (es. 239 o 228.5). |
Informazioni sulla traccia
| Colonna | Formato | Descrizione |
|---|---|---|
| Artist | Testo | Il nome dell'artista o interprete. |
| Title | Testo | Il titolo della traccia. |
| Album | Testo | Il nome dell'album. |
| Genre | Testo | Il genere (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 (es. upbeat;classic;80s). |
| Comments | Testo | Commenti in testo libero sulla traccia. |
| Out Cue | Testo | Il testo dell'Out Cue (es. "and don't it feel good!"). |
| ISRC | Testo | Il codice ISRC (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 un clip. |
Bed | Una base musicale di sottofondo. |
Station ID + Bed | Un'identificazione della stazione combinata con una base musicale di sottofondo. |
Se la colonna Type viene lasciata vuota, il tipo verrà dedotto automaticamente.
Punti di cue e temporizzazione
| Colonna | Formato | Predefinito | Descrizione |
|---|---|---|---|
| Intro | Secondi decimali | Non impostato | La durata dell'Intro. Il punto in cui iniziano le voci o il contenuto principale. |
| Cue In | Secondi decimali | 0 | Il punto di Cue In. La riproduzione inizia da questo punto. |
| Cue Out | Secondi decimali | Uguale a Duration | Il punto di Cue Out. La traccia successiva inizia a questo punto. |
| Early Out | Secondi decimali | Non impostato | Il punto di Early Out. Utilizzato per riprodurre uno Sweeper in anticipo. |
| Hook Start | Secondi decimali | Non impostato | L'inizio della sezione Hook della traccia. |
| Hook End | Secondi decimali | Non impostato | La fine della sezione Hook della traccia. |
Controllo della riproduzione
| Colonna | Formato | Predefinito | Descrizione |
|---|---|---|---|
| No Fade | Booleano | false | Impostare su true per disabilitare il Fade in uscita al punto di Cue Out della traccia. |
| Sweeper | Booleano | false | Impostare su true per contrassegnare la traccia come Sweeper e consentirle di riprodursi sopra altre tracce. |
| Disabled | Booleano | false | Impostare su true per escludere la traccia dalla pianificazione. |
| Valid From | Data | Non impostato | La data a mezzanotte da cui la traccia diventa disponibile (es. 2026-01-15). |
| Expires | Data | Non impostato | La data a mezzanotte dopo la quale la traccia non è più disponibile (es. 2026-02-15). |
| Ignore Validity Year? | Booleano | false | Impostare su true per ignorare la parte relativa all'anno di Valid From e Expires, in modo che la traccia si ripeta ogni anno tra quelle date. Ha effetto solo quando sono impostati sia Valid From che Expires. |
Elaborazione audio
| Colonna | Formato | Predefinito | Descrizione |
|---|---|---|---|
| Gain DB | Decimale | Non impostato | Regolazione del guadagno audio in decibel (es. -3.5). |
| Gain Set Manually? | Booleano | false | Impostare su true se il valore del guadagno è stato configurato manualmente anziché rilevato automaticamente dall'Analisi Loudness. |
| Loudness Target LUFS | Decimale | Non impostato | Il target di normalizzazione della loudness in LUFS memorizzato dalla funzione di Analisi Loudness. |
| Tempo Adjust Percentage | Decimale | Non impostato | Regolazione percentuale del tempo di riproduzione. |
Scaletta
| Colonna | Formato | Descrizione |
|---|---|---|
| Dayparting | Testo | Controlla quando la traccia è autorizzata a essere riprodotta. Il valore inizia con Y (abilitato) o N (disabilitato), seguito da coppie giorno-ora separate da punto e virgola nel formato DayCode|Hour. I codici giorno sono Mo, Tu, We, Th, Fr, Sa, Su. Le ore vanno da 0 a 23. Ad esempio, Y;Mo|09;Mo|10;Fr|14 abilita la traccia il lunedì alle 9 e alle 10, e il venerdì alle 14. |
Gestione degli errori
- Se una riga contiene un valore non corretto (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 extra non riconosciute da PlayIt Live vengono ignorate.
- Se un valore contiene una virgola, racchiuderlo tra virgolette doppie (es.
"Earth, Wind & Fire").