Importation de pistes au format CSV
PlayIt Live peut importer des pistes depuis un fichier CSV (valeurs séparées par des virgules) en utilisant l'Assistant d'Ajout de Nouvelles Pistes. Cela est utile lors de la migration de métadonnées de pistes depuis un autre système de playout, un outil de programmation musicale ou un tableur.
Avant de commencer
L'importateur CSV attend des données dans un format spécifique. Si vous exportez depuis un autre système, vous aurez presque certainement besoin de convertir et de reformater les données avant de pouvoir les importer dans PlayIt Live. Cela nécessite un certain effort manuel et une familiarité avec les outils de tableur tels que Microsoft Excel ou Google Sheets.
En particulier, toutes les valeurs de durée et de points de cue doivent être en secondes décimales. Les formats tels que 3:45 ou 0:08.5 ne sont pas acceptés car ils sont ambigus (ils pourraient représenter minutes:secondes ou heures:minutes). Vous devrez convertir ces valeurs vous-même avant l'importation. Consultez Formats de valeurs ci-dessous pour plus de détails.
La meilleure approche consiste à exporter d'abord quelques pistes depuis PlayIt Live en utilisant l'export CSV dans Gérer les Pistes. Cela vous fournit un modèle indiquant les noms de colonnes exacts et les formats de valeurs attendus par l'importateur.
Création d'un fichier CSV
Le fichier CSV doit comporter une ligne d'en-tête avec les noms des colonnes, suivie d'une ligne par piste. Vous pouvez créer le fichier dans n'importe quelle application de tableur et l'exporter au format CSV, ou le rédiger dans un éditeur de texte.
Exemple minimal
Au minimum, chaque piste nécessite un chemin de fichier et une durée :
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,354Exemple complet
Un fichier CSV plus complet avec des colonnes de temporisation et de métadonnées :
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,SongFormats de valeurs
Chaque colonne possède un format de valeur spécifique. L'utilisation d'un format incorrect entraînera l'omission de la ligne lors de l'importation.
Secondes décimales
Toutes les colonnes de durée et de points de cue doivent être en secondes décimales en utilisant un point (.) comme séparateur décimal.
| Correct | Incorrect |
|---|---|
239 | 3:59 |
8.5 | 0:08.5 |
228.75 | 3:48.75 |
0 | 0:00 |
Si vos données sources utilisent le format minutes:secondes, vous devrez les convertir. Dans un tableur, vous pouvez utiliser une formule telle que =MINUTE(A1)*60+SECOND(A1) pour convertir une valeur de temps dans la cellule A1 en secondes totales.
Texte
Les valeurs textuelles (Artist, Title, Album, etc.) sont des chaînes de caractères simples. Si une valeur contient une virgule, la valeur entière doit être entourée de guillemets doubles dans le fichier CSV. La plupart des applications de tableur gèrent cela automatiquement lors de l'exportation en CSV.
Booléen
Les colonnes booléennes (No Fade, Sweeper, Disabled, Ignore Validity Year?, Gain Set Manually?) acceptent true ou false (sans distinction de casse). Si la colonne est absente ou vide, la valeur par défaut est false.
Date
Les colonnes de date (Valid From, Expires) acceptent des formats de date standard tels que 2026-01-15. La partie heure est ignorée.
Décimal
Les colonnes décimales (Gain DB, Loudness Target LUFS, Tempo Adjust Percentage) utilisent un point (.) comme séparateur décimal. Par exemple, -3.5 pour une réduction de gain de 3,5 dB.
Référence des colonnes
Colonnes obligatoires
Seules les colonnes Path et Duration sont nécessaires pour une importation valide. Toutes les autres colonnes sont optionnelles. Si une colonne est absente de l'en-tête, le champ est laissé vide ou défini sur sa valeur par défaut.
| Colonne | Format | Description |
|---|---|---|
| Path | Texte | Le chemin complet vers le fichier audio sur le disque. Utilisé pour la lecture et la détection des doublons. |
| Duration ou Duration (seconds) | Secondes décimales | La durée totale de la piste (p. ex. 239 ou 228.5). |
Informations sur la piste
| Colonne | Format | Description |
|---|---|---|
| Artist | Texte | Le nom de l'artiste ou de l'interprète. |
| Title | Texte | Le titre de la piste. |
| Album | Texte | Le nom de l'album. |
| Genre | Texte | Le genre (p. ex. Pop, Rock, Jazz). |
| Year | Texte | L'année de sortie. |
| Type | Texte | Le type de piste. Doit être l'un des identifiants de type répertoriés ci-dessous, ou laissé vide. |
| Tags | Texte | Balises séparées par des points-virgules (p. ex. upbeat;classic;80s). |
| Comments | Texte | Commentaires en texte libre sur la piste. |
| Out Cue | Texte | Le texte du Out Cue (p. ex. « and don't it feel good! »). |
| ISRC | Texte | Le code ISRC (International Standard Recording Code). |
| Record Label | Texte | Le nom du label discographique. |
| Track ID | Texte | Un identifiant de piste personnalisé. |
Valeurs de type de piste
La colonne Type doit utiliser l'une des valeurs suivantes exactement telles qu'elles sont indiquées ci-dessous.
| Valeur | Description |
|---|---|
Song | Une piste musicale. |
Station ID | Un jingle d'identification de la station. |
Promo | Une annonce promotionnelle. |
Commercial | Une publicité ou un spot commercial. |
News | Un bulletin d'informations ou un clip. |
Bed | Un fond musical. |
Station ID + Bed | Une identification de station combinée avec un fond musical. |
Si la colonne Type est laissée vide, le type sera déduit automatiquement.
Points de cue et temporisation
| Colonne | Format | Valeur par défaut | Description |
|---|---|---|---|
| Intro | Secondes décimales | Non défini | La durée de l'Intro. Le point auquel les voix ou le contenu principal commence. |
| Cue In | Secondes décimales | 0 | Le point de Cue In. La lecture commence à partir de ce point. |
| Cue Out | Secondes décimales | Identique à Duration | Le point de Cue Out. La piste suivante commence à ce point. |
| Early Out | Secondes décimales | Non défini | Le point d'Early Out. Utilisé pour jouer un Sweeper en avance. |
| Hook Start | Secondes décimales | Non défini | Le début de la section Hook de la piste. |
| Hook End | Secondes décimales | Non défini | La fin de la section Hook de la piste. |
Contrôle de lecture
| Colonne | Format | Valeur par défaut | Description |
|---|---|---|---|
| No Fade | Booléen | false | Définir sur true pour désactiver le fondu en sortie au point de Cue Out de la piste. |
| Sweeper | Booléen | false | Définir sur true pour marquer la piste comme Sweeper et lui permettre de se jouer par-dessus d'autres pistes. |
| Disabled | Booléen | false | Définir sur true pour empêcher la piste d'être planifiée. |
| Valid From | Date | Non défini | La date à minuit à partir de laquelle la piste devient disponible (p. ex. 2026-01-15). |
| Expires | Date | Non défini | La date à minuit après laquelle la piste n'est plus disponible (p. ex. 2026-02-15). |
| Ignore Validity Year? | Booléen | false | Définir sur true pour ignorer la partie année de Valid From et Expires afin que la piste se répète chaque année entre ces dates. Ne prend effet que lorsque Valid From et Expires sont tous les deux définis. |
Traitement audio
| Colonne | Format | Valeur par défaut | Description |
|---|---|---|---|
| Gain DB | Décimal | Non défini | Ajustement du gain audio en décibels (p. ex. -3.5). |
| Gain Set Manually? | Booléen | false | Définir sur true si la valeur de gain a été configurée manuellement plutôt que détectée automatiquement par l'Analyse de Loudness. |
| Loudness Target LUFS | Décimal | Non défini | La cible de normalisation de loudness en LUFS enregistrée par la fonction d'Analyse de Loudness. |
| Tempo Adjust Percentage | Décimal | Non défini | Ajustement en pourcentage du tempo de lecture. |
Horaire
| Colonne | Format | Description |
|---|---|---|
| Dayparting | Texte | Contrôle les moments où la piste est autorisée à jouer. La valeur commence par Y (activé) ou N (désactivé), suivie de paires jour-heure séparées par des points-virgules au format DayCode|Hour. Les codes de jour sont Mo, Tu, We, Th, Fr, Sa, Su. Les heures vont de 0 à 23. Par exemple, Y;Mo|09;Mo|10;Fr|14 active la piste le lundi à 9 h et 10 h, et le vendredi à 14 h. |
Gestion des erreurs
- Si une ligne contient une valeur incorrecte (p. ex. du texte dans une colonne numérique), cette ligne est ignorée et l'erreur est consignée. Le reste de l'importation se poursuit.
- Les colonnes peuvent apparaître dans n'importe quel ordre dans le fichier CSV.
- Les colonnes supplémentaires non reconnues par PlayIt Live sont ignorées.
- Si une valeur contient une virgule, entourez-la de guillemets doubles (p. ex.
"Earth, Wind & Fire").