Importation de pistes CSV

PlayIt VoiceTrack peut importer des pistes depuis un fichier CSV (Comma-Separated Values) à l'aide de l'Assistant d'Ajout de Nouvelles Pistes. Cela est utile lors de la migration des métadonnées de pistes depuis un autre système de playout, un outil de planification 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 reformater les données avant de pouvoir les importer dans PlayIt VoiceTrack. Cela nécessite un certain effort manuel et une certaine familiarité avec des outils tableur tels que Microsoft Excel ou Google Sheets.

En particulier, toutes les valeurs de durée et de Cue Point 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 des minutes:secondes ou des heures:minutes). Vous devrez convertir ces valeurs vous-même avant l'importation. Voir Formats de valeurs ci-dessous pour plus de détails.

La meilleure approche consiste à exporter d'abord quelques pistes depuis PlayIt VoiceTrack à l'aide de l'export CSV dans Gérer les Pistes. Cela vous donne un modèle indiquant les noms de colonnes exacts et les formats de valeurs que l'importateur attend.

Création d'un fichier CSV

Le fichier CSV doit comporter une ligne d'en-tête avec les noms de colonnes, suivie d'une ligne par piste. Vous pouvez créer le fichier dans n'importe quelle application 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,354

Exemple 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,Song

Formats de valeurs

Chaque colonne a un format de valeur spécifique. L'utilisation d'un format incorrect entraînera le saut de la ligne lors de l'importation.

Secondes décimales

Toutes les colonnes de durée et de Cue Point doivent être en secondes décimales avec 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 texte (Artist, Title, Album, etc.) sont des chaînes de caractères simples. Si une valeur contient une virgule, la valeur entière doit être placée entre guillemets doubles dans le fichier CSV. La plupart des applications tableur gèrent cela automatiquement lors de l'exportation au format CSV.

Booléen

Les colonnes booléennes (No Fade, Sweeper, Disabled, Gain Set Manually?) acceptent true ou false (insensible à la casse). Si la colonne est absente ou vide, la valeur par défaut est false.

Date

Les colonnes de date (Valid From, Expires) acceptent les 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 requises

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 à sa valeur par défaut.

Colonne	Format	Description
Path	Texte	Le chemin complet du 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 listés ci-dessous, ou laissé vide.
Tags	Texte	Tags séparés par des points-virgules (p. ex. `upbeat;classic;80s`).
Comments	Texte	Commentaires en texte libre sur la piste.
Out Cue	Texte	Le texte de l'out cue (p. ex. « and don't it feel good! »).
ISRC	Texte	L'International Standard Recording Code.
Record Label	Texte	Le nom du label discographique.
Track ID	Texte	Un identifiant de piste personnalisé.

Valeurs du type de piste

La colonne Type doit utiliser l'une des valeurs suivantes exactement comme indiqué ci-dessous.

Valeur	Description
`Song`	Une piste musicale.
`Station ID`	Un jingle d'identification de station.
`Promo`	Une annonce promotionnelle.
`Commercial`	Un spot publicitaire ou une annonce commerciale.
`News`	Un bulletin d'informations ou un clip.
`Bed`	Une musique de fond.
`Station ID + Bed`	Une identification de station combinée avec une musique de fond.

Si la colonne Type est laissée vide, le type sera déduit automatiquement.

Cue Points et temporisation

Colonne	Format	Par défaut	Description
Intro	Secondes décimales	0	La durée de l'Intro. Le point à partir duquel les voix ou le contenu principal commence.
Cue In	Secondes décimales	0	Le point Cue In. La lecture démarre à partir de ce point.
Cue Out	Secondes décimales	Identique à Duration	Le point Cue Out. La piste est considérée comme terminée à ce point.
Early Out	Secondes décimales	Non défini	Le point Early Out. Indique l'endroit où la piste est presque terminée.
Hook Start	Secondes décimales	Non défini	Le début de la section Hook de la piste. Les Hooks ne sont utilisés que par PlayIt Live et sont ignorés par PlayIt VoiceTrack.
Hook End	Secondes décimales	Non défini	La fin de la section Hook de la piste. Les Hooks ne sont utilisés que par PlayIt Live et sont ignorés par PlayIt VoiceTrack.

Contrôle de lecture

Colonne	Format	Par défaut	Description
No Fade	Booléen	false	Définir à `true` pour désactiver le fondu en fin de piste.
Sweeper	Booléen	false	Définir à `true` pour marquer la piste comme Sweeper ou jingle.
Disabled	Booléen	false	Définir à `true` pour empêcher la piste d'être programmée ou lue.
Valid From	Date	Non défini	La date à partir de laquelle la piste devient disponible (p. ex. `2026-01-15`).
Expires	Date	Non défini	La date après laquelle la piste n'est plus disponible.

Traitement audio

Colonne	Format	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 à `true` si la valeur de gain a été configurée manuellement plutôt que détectée automatiquement.
Loudness Target LUFS	Décimal	Non défini	La cible de normalisation du volume en LUFS.
Tempo Adjust Percentage	Décimal	Non défini	Ajustement en pourcentage du tempo de lecture.

Gestion des erreurs

Si une ligne contient une valeur mal formée (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 VoiceTrack sont ignorées.
Si une valeur contient une virgule, placez-la entre guillemets doubles (p. ex. "Earth, Wind & Fire").